{
  "openapi": "3.1.0",
  "info": {
    "title": "Ed-Fi UDM",
    "description": "The Ed-Fi API serves the Ed-Fi Data Standard v6.1 model: canonical resources, a descriptor registry collapsing descriptor types into rows discriminated by descriptor_type, and import/export/conformance command receipts. It uses the Ed-Fi REST surface with offset pagination, bare envelopes, RFC 7807 errors, and fixed per-field query filters. Roster-anchored entities reference OneRoster sourcedIds.",
    "version": "1.0"
  },
  "tags": [
    {
      "name": "Academic Week",
      "description": "A labeled instructional week within a school calendar, with begin/end dates and total instructional days."
    },
    {
      "name": "Accountability Rating",
      "description": "An accountability rating for a school or district. Natural key: (educationOrganizationSourcedId, ratingTitle, schoolYear)."
    },
    {
      "name": "Applicant Profile",
      "description": "The profile of the person making an application. Inline Common/Choice children (Name, Address, Telephone, etc.) folded as jsonb."
    },
    {
      "name": "Application",
      "description": "An application for employment or acceptance. Score results, terms, and recruitment event attendance links folded as jsonb."
    },
    {
      "name": "Application Event",
      "description": "A life-cycle event associated with an application."
    },
    {
      "name": "Assessment",
      "description": "An assessment instrument administered to students. Carries metadata about the assessment including category, version, academic subjects, and score definitions. Collection children capture scores, performance levels, academic subjects, and identification codes. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Assessment Administration",
      "description": "An expected administration of an assessment by an assigning education organization, identified by administrationIdentifier. Periods and battery parts are folded jsonb collections."
    },
    {
      "name": "Assessment Administration Participation",
      "description": "Indicates that a participating education organization is involved in an assessment administration. Point-of-contact collection folded to jsonb."
    },
    {
      "name": "Assessment Battery Part",
      "description": "A named part of an assessment battery, optionally linking objective assessments administered as part of the battery."
    },
    {
      "name": "Assessment Item",
      "description": "An individual question or task on an assessment. Each item belongs to an assessment and may be linked to objective assessments and learning standards."
    },
    {
      "name": "Assessment Score Range Learning Standard",
      "description": "Associates a score range on an assessment (or objective assessment) with one or more learning standards."
    },
    {
      "name": "Balance Sheet Dimension",
      "description": "The NCES balance sheet accounting dimension, used to track financial transactions for each fund. Reporting tags folded as jsonb."
    },
    {
      "name": "Bell Schedule",
      "description": "An Ed-Fi bell schedule defining the time structure for a school day. Keyed on the school's OneRoster sourcedId and bell schedule name. Collection children carry class period assignments, meeting times, and applicable dates. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Calendar",
      "description": "An Ed-Fi calendar associated with a school for a given school year. Identified by the school, a calendar code, and the school year. Collection children carry grade levels and calendar-date events. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Calendar Date",
      "description": "A specific date within a school calendar. This is the real source-backed base entity that the Alpha school_calendar command in peopleAndOrgs reads from. Each calendar date may carry one or more calendar events (instructional day, holiday, etc.) via the calendarDateCalendarEvent child."
    },
    {
      "name": "Calendar Date Calendar Event",
      "description": "An event type associated with a specific calendar date (e.g. Instructional day, Holiday, Teacher only day). The calendarEventDescriptor discriminates the event type on a given date."
    },
    {
      "name": "Candidate",
      "description": "An educator-preparation candidate. Name and birth data inlined as scalars (Inline Common fold); addresses, telephones, and other commons folded as jsonb. Optional Person correlation."
    },
    {
      "name": "Candidate Educator Preparation Program Association",
      "description": "Association between a candidate and an educator preparation program. Optional Application reference stored as plain scalars (Application is P6; command-layer validation). Inline commons folded as jsonb."
    },
    {
      "name": "Candidate Identification Code",
      "description": "An identification code for a candidate within an education organization context."
    },
    {
      "name": "Candidate Relationship To Staff Association",
      "description": "Association relating a candidate to a staff member (e.g., mentor). Staff is roster-anchored via oneroster:user.sourcedId."
    },
    {
      "name": "Certification",
      "description": "An offering by an official granting authority of a certification or license that qualifies persons to perform specific job functions. Natural key: (certificationIdentifier, namespace). Grade levels, routes, and exam associations are folded jsonb collections."
    },
    {
      "name": "Certification Exam",
      "description": "An examination required by one or more certifications. Natural key: (certificationExamIdentifier, namespace)."
    },
    {
      "name": "Certification Exam Result",
      "description": "The person's result from taking a certification exam. Natural key is the certificationExam composite key plus person composite key plus certificationExamDate. Optional studentAssessment reference is a scalar identifier with command-layer validation (studentAssessment has a multi-column key)."
    },
    {
      "name": "Chart of Account",
      "description": "A financial account used by an education organization to track revenues and expenditures, identified by account identifier and fiscal year."
    },
    {
      "name": "Class Period",
      "description": "An Ed-Fi class period defining a named time block used for scheduling within a school. Keyed on the school's OneRoster sourcedId and class period name. Collection children carry meeting time definitions. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Cohort",
      "description": "A group of students organized for a common purpose, such as a counseling group, intervention group, or study group at an education organization."
    },
    {
      "name": "Community Organization",
      "description": "A community-based organization that may provide services or partner with education organizations. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Community Provider",
      "description": "A community provider organization that delivers services such as child care, after-school programs, or other community-based services. May be associated with a community organization. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Community Provider License",
      "description": "A license record for a community provider, tracking the licensing organization, type, effective dates, and authorized capacity."
    },
    {
      "name": "Competency Objective",
      "description": "A measurable instructional objective tied to a specific grade level and education organization. Defines what a student should know or be able to do, with optional description and success criteria. Anchored to a OneRoster organization via `schoolSourcedId`."
    },
    {
      "name": "Conformance evidence",
      "description": "A UDM-coverage and descriptor-governance conformance evidence record. Generated by `getConformanceEvidence` to prove Ed-Fi Data Standard coverage, roster-boundary compliance, and descriptor registry completeness."
    },
    {
      "name": "Contact",
      "description": "A contact or guardian demographic record in the Ed-Fi UDM. Contact uses `contactUniqueId` as its own identity and is NOT roster-anchored (no OneRoster sourcedId FK). Collection children reference back via composite FK on contactUniqueId. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Contact Identification Code",
      "description": "A coding scheme used to identify a contact, discriminated by identification system and education organization context. Standalone Domain Entity (not a folded common)."
    },
    {
      "name": "Course",
      "description": "Ed-Fi course surface — a multi-base security_invoker projection of the oneroster:course union master (primary) joined 1:1 to `edfi:courseExtension` (owned companion). Shared roster fields (title, courseCode, owning org) rename via from; Ed-Fi-only credits/adoption/collections live on the companion so they never ALTER onto the shared OneRoster course master. Join presence is optional (LEFT JOIN): every extension field was nullable, so a bare roster course remains visible with no companion row. Detail routes by a derived-hash GUID of (educationOrganizationId, courseCode). Shared-field UPDATE requires edfi:write-shared; extension fields are writable under edfi:write."
    },
    {
      "name": "Course Offering",
      "description": "A course offering representing a specific course offered by a school in a given school year and session. Links to the parent Course via educationOrganizationId+courseCode and anchors to the roster boundary via schoolSourcedId. Collection children capture course level characteristics, curriculum used, and offered grade levels. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Course Transcript",
      "description": "A student's transcript record for a specific course, linking the student (via OneRoster user sourcedId) to a course (via educationOrganizationId+courseCode) within a school year and term. Records final grades, earned/attempted credits, and course attempt outcome. Collection children capture academic subjects, alternative course identification codes, course programs, credit categories, earned additional credits, partial course transcript awards, and section associations. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Credential",
      "description": "The legal document giving authorization to perform teaching assignment services. Natural key: (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor). Grade levels, academic subjects, endorsements, and student academic records are folded jsonb collections. Optional certification and person references use flat multi-column keys."
    },
    {
      "name": "Credential Event",
      "description": "An event associated with a person's credential. Natural key is the credential composite key plus credentialEventDate and credentialEventTypeDescriptor."
    },
    {
      "name": "Crisis Event",
      "description": "A natural or man-made event that causes the disruption of school-level activities and the temporary or permanent displacement of students. Natural key: (crisisEventName)."
    },
    {
      "name": "Descriptor",
      "description": "A governed descriptor value in the Ed-Fi tag registry. Collapses 280 Ed-Fi descriptor types into one entity discriminated by `descriptor_type`. A descriptor value missing from this registry at write time fails loud with `edfi:descriptor_not_governed`."
    },
    {
      "name": "Descriptor Mapping",
      "description": "Maps a descriptor value in one namespace to a descriptor value in another namespace, optionally scoped to model entities."
    },
    {
      "name": "Discipline Action",
      "description": "A disciplinary action taken against a student in response to a discipline incident. Contains the action length, type, and related indicators. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Discipline Incident",
      "description": "An incident reported at a school that may involve one or more behaviors, students, and staff members. Serves as the parent for disciplineIncidentBehavior collection children. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Ed-Fi draft record",
      "description": "A pre-canonical draft of an Ed-Fi resource that has not yet been promoted. Drafts never satisfy cross-resource references and never appear in canonical list endpoints until promoted via `promoteDraftRecord`."
    },
    {
      "name": "Education Content",
      "description": "A learning resource or content item with metadata describing its publication, cost, interactivity, and rights. Identified by a unique content identifier. Collection children capture appropriate grade levels, sexes, authors, derivative sources, and languages. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Education Organization",
      "description": "Base Ed-Fi education organization resource. Concrete subclasses (School, LocalEducationAgency, EducationOrganizationNetwork, OrganizationDepartment, etc.) specialize this identity. NOT roster-anchored; keyed on educationOrganizationId. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Education Organization Identification Code",
      "description": "A coding scheme used to identify an education organization, discriminated by identification system. Standalone Domain Entity in v6.1 (not the folded identificationCodes[] common on EducationOrganization subclasses)."
    },
    {
      "name": "Education Organization Intervention Prescription Association",
      "description": "Indicates interventions made available by an education organization. Natural key is the making-available education organization plus the interventionPrescription composite key."
    },
    {
      "name": "Education Organization Network",
      "description": "An Ed-Fi education organization network — a collection of education organizations (e.g. consortia, collaboratives) connected for a specific purpose. Keyed on a locally-assigned educationOrganizationNetworkId. NOT roster-anchored. Collection children carry addresses, categories, identification codes, and telephone numbers. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Education Organization Network Association",
      "description": "Associates a member education organization with an education organization network, with optional membership dates."
    },
    {
      "name": "Education Organization Peer Association",
      "description": "Associates an education organization with a peer education organization."
    },
    {
      "name": "Education Service Center",
      "description": "An Ed-Fi education service center (ESC) — a regional or intermediate service agency that provides support services to school districts. Keyed on a locally-assigned educationServiceCenterId. NOT roster-anchored. Collection children carry addresses, categories, identification codes, and telephone numbers. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Educator Preparation Program",
      "description": "An educator preparation program operated by an education organization. Education organization uses OneRoster org sourcedId. Grade levels folded as jsonb."
    },
    {
      "name": "Evaluation",
      "description": "An evaluation within a performance evaluation. FK to PerformanceEvaluation via the 6-column composite natural key."
    },
    {
      "name": "Evaluation Element",
      "description": "An element within an evaluation objective. FK to EvaluationObjective via the 8-column composite natural key."
    },
    {
      "name": "Evaluation Element Rating",
      "description": "A rating of an evaluation element under an evaluation objective rating. FK to EvaluationObjectiveRating; evaluationElementTitle identifies the EvaluationElement."
    },
    {
      "name": "Evaluation Objective",
      "description": "An objective within an evaluation. FK to Evaluation via the 7-column composite natural key."
    },
    {
      "name": "Evaluation Objective Rating",
      "description": "A rating of an evaluation objective under an evaluation rating. FK to EvaluationRating; evaluationObjectiveTitle identifies the EvaluationObjective."
    },
    {
      "name": "Evaluation Rating",
      "description": "A rating of a specific evaluation under a performance evaluation rating. FK to PerformanceEvaluationRating; evaluationTitle identifies the Evaluation. Optional section legs are plain scalars. Reviewers/results folded as jsonb."
    },
    {
      "name": "Evaluation Rubric Dimension",
      "description": "A rubric dimension for a program evaluation element. FK to ProgramEvaluationElement via the 7-column composite natural key."
    },
    {
      "name": "Export job",
      "description": "A bulk export receipt tracking the lifecycle of one Ed-Fi data export. Satisfies."
    },
    {
      "name": "Feeder School Association",
      "description": "An association linking a feeder school to a receiving school with effective date range. Both school references are cross-module roster FKs to oneroster:org.sourcedId."
    },
    {
      "name": "Fieldwork Experience",
      "description": "A fieldwork experience for a student (often an EPP candidate acting as student). Optional school and EPP refs; coteaching folded as jsonb."
    },
    {
      "name": "Fieldwork Experience Section Association",
      "description": "Associates a fieldwork experience with a section. Section legs follow the ODS wire shape (sessionName); school is oneroster:org."
    },
    {
      "name": "Financial Aid",
      "description": "The financial aid a person is awarded. Natural key: (studentSourcedId, beginDate, aidTypeDescriptor)."
    },
    {
      "name": "Function Dimension",
      "description": "The NCES function accounting dimension representing an expenditure activity. Reporting tags folded as jsonb."
    },
    {
      "name": "Fund Dimension",
      "description": "The NCES fund accounting dimension — a fiscal and accounting entity with a self-balancing set of accounts. Reporting tags folded as jsonb."
    },
    {
      "name": "General Student Program Association",
      "description": "This association represents the program(s) that a student participates in or receives services from. Each row represents one effective participation period for a (student, program-org, program-name, program-type) subject — keyed by (studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). The begin/end dates form the effective-dated history: a student may have multiple non-overlapping participation periods in the same program, distinguished by beginDate. Roster FK legs link to OneRoster user (student) and org (program education organization). This is the generalized base; specific subtypes (studentProgramAssociation, studentSpecialEducationProgramAssociation, studentTitleIPartAProgramAssociation) inherit the same key shape."
    },
    {
      "name": "General Student Program Association Program Participation Status",
      "description": "The status of a student's program participation over time. A multi-valued collection child of generalStudentProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators."
    },
    {
      "name": "Goal",
      "description": "A goal assigned to a person, optionally linked to an evaluation objective/element. Parent goal and evaluation construct links are plain scalars (self-ref / dual-optional FK; command-layer validation)."
    },
    {
      "name": "Grade",
      "description": "A grade awarded to a student for a specific section during a grading period. Links the student and school via OneRoster roster foreign keys."
    },
    {
      "name": "Gradebook Entry",
      "description": "A gradebook assignment or activity identified by gradebookEntryIdentifier and namespace. Optional section and grading period references use Ed-Fi natural-key legs. Learning standards folded as jsonb array."
    },
    {
      "name": "Grading Period",
      "description": "An Ed-Fi grading period defining a span of time during which grades are reported for a school. Keyed on the school's OneRoster sourcedId plus grading period descriptor, period sequence, and school year."
    },
    {
      "name": "Graduation Plan",
      "description": "A plan defining the graduation requirements for a cohort of students at an education organization. Specifies required credits, courses, and assessments. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "IDEA Event",
      "description": "An IDEA-related special education event for a student in an education organization context. Roster-anchored on student; education organization uses OneRoster org sourcedId."
    },
    {
      "name": "Import job",
      "description": "A bulk import receipt tracking the lifecycle of one complete-model Ed-Fi import batch. Created by `createImportJob`; each row in the batch produces an `importRow` evidence record."
    },
    {
      "name": "Import row",
      "description": "Per-row evidence for a bulk import job. Each row in an import batch produces one record capturing its payload, validation outcome, and final record state. Keyed by server-uuid; uniqueness of (importJobId, rowIndex) is enforced by a unique index."
    },
    {
      "name": "Intervention",
      "description": "An intervention program offered by an education organization to address academic or behavioral needs. Defines the classification, delivery method, dosage bounds, and active date range."
    },
    {
      "name": "Intervention Prescription",
      "description": "A template or prescribed intervention program that can be implemented at one or more education organizations. Defines the classification, delivery method, and dosage bounds without binding to specific dates."
    },
    {
      "name": "Intervention Study",
      "description": "A research study evaluating the effectiveness of an intervention. Captures the classification, delivery method, number of participants, and effectiveness rating."
    },
    {
      "name": "Learning Standard",
      "description": "An Ed-Fi learning standard — a multi-base projection of `case:cfItem` (primary) joined 1:1 to `edfi:learningStandardExtension` (secondary companion). Shared text fields (statement, URI, human code) rename from the CFItem; Ed-Fi-only identity (`learningStandardId`) and collections live on the companion so they never ALTER onto the shared CASE cf_item master as NOT NULL extends. Detail routes by the CASE `identifier` (mapped; the multi-base grammar cannot hash a joined companion column into a projection-side derivedHash GUID). Create supplies the CASE identifier (uuid) alongside the Ed-Fi natural key."
    },
    {
      "name": "Learning Standard Equivalence Association",
      "description": "A standalone association indicating that two learning standards are equivalent in content or intent. Keyed on the ordered pair (sourceLearningStandardId, targetLearningStandardId), both FK to LearningStandard. Owns its own route."
    },
    {
      "name": "Local Account",
      "description": "A code segment within a financial account that classifies the account according to a specific dimension (e.g., fund, function, object). Collection child of Account."
    },
    {
      "name": "Local Actual",
      "description": "An actual expenditure or revenue transaction recorded against a financial account as of a specific date."
    },
    {
      "name": "Local Budget",
      "description": "A budget allocation recorded against a financial account as of a specific date."
    },
    {
      "name": "Local Contracted Staff",
      "description": "A contracted staff expenditure recorded for a staff member against a financial account as of a specific date, tracking amounts paid to date."
    },
    {
      "name": "Local Education Agency",
      "description": "An Ed-Fi local education agency (LEA) — a multi-base read/write view over `oneroster:org` (primary) joined 1:1 to `edfi:localEducationAgencyExtension` (owned companion) for the org rows of type \"district\". Roster-shared fields (sourcedId, name, type) rename from the org; Ed-Fi-only descriptors and collections live on the companion (the old lea- prefixes dropped — the companion table is LEA-owned, so wire names are the column names). Join presence is optional (LEFT JOIN): every extension field was nullable, so a bare roster org remains visible with no companion row. Detail routes by a stable derived GUID. Updating a shared field requires `edfi:write-shared` in addition to `edfi:write`."
    },
    {
      "name": "Local Encumbrance",
      "description": "The set of local education agency or charter management organization encumbrance amounts against a financial account as of a specific date."
    },
    {
      "name": "Local Payroll",
      "description": "A payroll expenditure recorded for a staff member against a financial account as of a specific date."
    },
    {
      "name": "Location",
      "description": "A classroom or instructional location within a school, identified by classroomIdentificationCode."
    },
    {
      "name": "Object Dimension",
      "description": "The NCES object accounting dimension representing an expenditure classification. Reporting tags folded as jsonb."
    },
    {
      "name": "Objective Assessment",
      "description": "A sub-component of an assessment that tests a specific learning objective or standard. Each objective assessment belongs to an assessment identified by assessmentIdentifier and namespace. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Open Staff Position",
      "description": "A record of a staff position vacancy within an education organization, including posting dates, classification, and employment status."
    },
    {
      "name": "Open Staff Position Event",
      "description": "Represents significant milestones related to an open staff position. Natural key is the openStaffPosition composite key plus eventDate and openStaffPositionEventTypeDescriptor."
    },
    {
      "name": "Operational Unit Dimension",
      "description": "The NCES operational unit accounting dimension used to segregate costs by school and operational unit. Reporting tags folded as jsonb."
    },
    {
      "name": "Organization Department",
      "description": "An organizational unit (department) within a parent education organization. Domain Entity Subclass of EducationOrganization; keyed on organizationDepartmentId. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Path",
      "description": "A path of study associated with an education organization, optionally linked to a graduation plan."
    },
    {
      "name": "Path Milestone",
      "description": "A milestone that may be associated with one or more path phases."
    },
    {
      "name": "Path Phase",
      "description": "A phase within a path of study. Associated path milestones are folded as a jsonb reference collection."
    },
    {
      "name": "Performance Evaluation",
      "description": "A performance evaluation definition for an education organization, term, school year, and evaluation period. Rating levels and grade levels folded as jsonb."
    },
    {
      "name": "Performance Evaluation Rating",
      "description": "A rating of a person against a performance evaluation. FK to Person and PerformanceEvaluation. Results and reviewers folded as jsonb."
    },
    {
      "name": "Person",
      "description": "A unique person identity in the Ed-Fi UDM, discriminated by source system. Used to correlate Student, Staff, Contact, and Candidate records that represent the same individual. NOT roster-anchored."
    },
    {
      "name": "Post-Secondary Event",
      "description": "A record of a post-secondary event for a student, such as college application, acceptance, or enrollment. The student reference is a cross-module roster FK to oneroster:user.sourcedId."
    },
    {
      "name": "Post-Secondary Institution",
      "description": "An Ed-Fi post-secondary institution — a college, university, or technical school. Keyed on a locally-assigned postSecondaryInstitutionId. NOT roster-anchored. Collection children carry addresses, categories, identification codes, and telephone numbers. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Professional Development Event",
      "description": "Information about a professional development event."
    },
    {
      "name": "Professional Development Event Attendance",
      "description": "Recording of whether a person attended a professional development event."
    },
    {
      "name": "Program",
      "description": "An instructional program operated by an education organization (e.g., Title I, Special Education, Gifted and Talented). Anchored to a OneRoster organization via `educationOrganizationId`. Collection children capture program characteristics, sponsors, and learning standard associations. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Program Dimension",
      "description": "A dimension or category used to organize reporting within a program. FK to Program via the 3-column composite key (educationOrganizationId, programName, programTypeDescriptor). Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Program Evaluation",
      "description": "A formal evaluation of a program, with rating bounds and period/type classification. FK to Program via the 3-column composite key (educationOrganizationId, programName, programTypeDescriptor). Children capture rating levels, elements, and objectives. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Program Evaluation Element",
      "description": "A specific element or component within a program evaluation, with its own title, description, and rating bounds. FK to ProgramEvaluation via the 6-column composite key. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Program Evaluation Objective",
      "description": "A specific objective within a program evaluation, with its own title, description, and rating bounds. FK to ProgramEvaluation via the 6-column composite key. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Project Dimension",
      "description": "The NCES project accounting dimension for accumulating expenditures by project. Reporting tags folded as jsonb."
    },
    {
      "name": "Quantitative Measure",
      "description": "A quantitative measure defined on an evaluation element. FK to EvaluationElement via the 8-column composite natural key."
    },
    {
      "name": "Quantitative Measure Score",
      "description": "A score for a quantitative measure under an evaluation element rating. FK to EvaluationElementRating; quantitativeMeasureIdentifier identifies the QuantitativeMeasure."
    },
    {
      "name": "Recruitment Event",
      "description": "Events associated with the recruitment process."
    },
    {
      "name": "Recruitment Event Attendance",
      "description": "A prospect for employment or acceptance who attended a recruitment event. Name and other commons folded as jsonb."
    },
    {
      "name": "Report Card",
      "description": "A student's report card for a specific grading period at a school. Links the student and school via OneRoster roster foreign keys. Collection children capture grades and GPAs. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Restraint Event",
      "description": "A record of a restraint event involving a student at a school. The student and school references are cross-module roster FKs. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Rubric Dimension",
      "description": "A rubric dimension on an evaluation element. FK to EvaluationElement via the 8-column composite natural key."
    },
    {
      "name": "School",
      "description": "An Ed-Fi school — a multi-base read/write view over `oneroster:org` (primary) joined 1:1 to `edfi:schoolExtension` (owned companion) for the org rows of type \"school\". Roster-shared fields (sourcedId, name, type) rename from the org; Ed-Fi-only descriptors and collections live on the companion so they never ALTER onto the shared OneRoster org master. Join presence is optional (LEFT JOIN): every extension field was nullable, so a bare roster org remains visible with no companion row. Detail routes by a stable derived GUID. Updating a shared field requires `edfi:write-shared` in addition to `edfi:write`."
    },
    {
      "name": "Section",
      "description": "An Ed-Fi section — a multi-base read/write view over `oneroster:class` (primary) joined 1:1 to `edfi:sectionExtension` (secondary companion). Roster-shared fields (sourcedId, title, school) rename from the class; Ed-Fi natural-key legs and scheduling facts live on the companion so they never ALTER onto the shared OneRoster class master as NOT NULL extends. Detail routes by a derived GUID of classSourcedId. Updating a shared field requires `edfi:write-shared` in addition to `edfi:write`."
    },
    {
      "name": "Section Attendance Taken Event",
      "description": "A record indicating that attendance was taken for a specific section on a given date. Captures who took attendance and for which calendar. Links the school and class via OneRoster roster foreign keys."
    },
    {
      "name": "Session",
      "description": "An Ed-Fi session — a multi-base read/write view over `oneroster:academicSession` (primary) joined 1:1 to `edfi:sessionExtension` (owned companion) for rows of type \"term\" or \"semester\". Roster-shared fields (title, dates, schoolYear, school) rename or cast; Ed-Fi-only facts live on the companion so they never ALTER onto the shared OneRoster academicSession master. Join presence is optional (LEFT JOIN): every extension field was nullable, so a bare roster session remains visible with no companion row. Detail routes by a derived GUID. Updating a shared field also requires `edfi:write-shared`."
    },
    {
      "name": "Source Dimension",
      "description": "The NCES source dimension used to segregate revenues/costs by funding source. Reporting tags folded as jsonb."
    },
    {
      "name": "Staff",
      "description": "An Ed-Fi staff surface — a multi-base read/write view over `oneroster:user` (primary, shared with edfi:student) joined 1:1 to `edfi:staffExtension` (owned companion). Roster-shared fields (name) rename via `from`; Ed-Fi-only demographic facts and collections live on the companion (the old staff- prefixes dropped — the companion table is staff-owned, so wire names are the column names). Join presence is optional (LEFT JOIN): every extension field was nullable, so a bare roster user is a valid staff row with no companion — create adopts the roster row and upserts the extension. Routes by a derived GUID of staffSourcedId (same physical GENERATED id on oneroster:user as edfi:student). Shared-field UPDATE needs edfi:write-shared."
    },
    {
      "name": "Staff Absence Event",
      "description": "Recording of the dates of staff absence. Natural key: (staffSourcedId, eventDate, absenceEventCategoryDescriptor)."
    },
    {
      "name": "Staff Cohort Association",
      "description": "An association linking a staff member to a cohort. Records the staff member's assignment to a specific cohort at an education organization with begin and optional end dates, and whether they have access to student records."
    },
    {
      "name": "Staff Demographic",
      "description": "Staff demographic information reported in an education organization context. Roster-anchored on staff. Inline collections folded to jsonb."
    },
    {
      "name": "Staff Directory",
      "description": "Staff directory contact information in an education organization context. Inline collections folded to jsonb."
    },
    {
      "name": "Staff Discipline Incident Association",
      "description": "Indicates those staff who were victims, perpetrators, witnesses, and reporters for a discipline incident. Natural key: (staffSourcedId, schoolSourcedId, incidentIdentifier). Participation codes are a required folded descriptor collection."
    },
    {
      "name": "Staff Education Organization Assignment Association",
      "description": "This association indicates the education organization to which a staff member provides services. Carries an effectiveDated declaration on (staffSourcedId, educationOrganizationSourcedId, staffClassificationDescriptor) with beginDate/endDate to support as-of queries for staff classification assignment periods. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Staff Education Organization Employment Association",
      "description": "This association indicates the education organization to which a staff member is employed. Carries an effectiveDated declaration on (staffSourcedId, educationOrganizationSourcedId, employmentStatusDescriptor) with hireDate/endDate to support as-of queries for staff employment periods. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Staff Educator Preparation Program Association",
      "description": "Association between a staff member and an educator preparation program."
    },
    {
      "name": "Staff Identification Code",
      "description": "A coding scheme used to identify a staff member, discriminated by identification system descriptor and identification code."
    },
    {
      "name": "Staff Leave",
      "description": "Recording of the dates of staff leave (e.g., sick leave, personal time, vacation). Natural key: (staffSourcedId, beginDate, staffLeaveEventCategoryDescriptor)."
    },
    {
      "name": "Staff Program Association",
      "description": "Association indicating the staff associated with a program. Natural key is staff plus the program composite key plus beginDate. Program education organization is the program.educationOrganizationId leg (oneroster:org sourcedId)."
    },
    {
      "name": "Staff School Association",
      "description": "This association indicates the school(s) to which a staff member provides instructional services. Carries an effectiveDated declaration on (staffSourcedId, schoolSourcedId) with beginDate/endDate to support as-of queries for staff assignment periods. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Staff Section Association",
      "description": "An Ed-Fi staff section association — a multi-base read/write view over `oneroster:enrollment` (primary) joined 1:1 to `edfi:staffSectionAssociationExtension` (owned companion) for rows of role \"teacher\". Roster-shared fields (staff, class, school, dates) rename; Ed-Fi-only facts live on the companion so they never ALTER onto the shared OneRoster enrollment master. Join presence is optional (LEFT JOIN): every extension field was nullable, so a bare roster enrollment remains visible with no companion row. Detail routes by a derived GUID. Updating a shared field also requires `edfi:write-shared`."
    },
    {
      "name": "State Education Agency",
      "description": "An Ed-Fi state education agency (SEA) — the state-level authority overseeing public education. Keyed on a locally-assigned stateEducationAgencyId. NOT roster-anchored (no OneRoster org FK). Collection children carry addresses, categories, identification codes, and telephone numbers. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student",
      "description": "An Ed-Fi student — a multi-base read/write view over `oneroster:user` (primary) joined 1:1 to `edfi:studentExtension` (owned companion). Roster-shared fields (sourcedId, name) rename from the user; Ed-Fi-only demographic facts and collections live on the companion so they never ALTER onto the shared OneRoster user master. Join presence is optional (LEFT JOIN): every extension field was nullable, so a bare roster user is a valid student row with no companion — create adopts the roster row and upserts the extension. Detail routes by a derived GUID. Updating a shared field also requires `edfi:write-shared`."
    },
    {
      "name": "Student Academic Record",
      "description": "A student's cumulative academic record for a specific education organization, school year, and term. Contains GPA, credits earned, class ranking, and academic honors as collection children. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Assessment",
      "description": "A record of a student taking an assessment on a particular date. Links the student (via roster FK) to an assessment and captures the administration context including date, environment, and event details. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Assessment Education Organization Association",
      "description": "Associates a student assessment result with an education organization and association type."
    },
    {
      "name": "Student Assessment Registration",
      "description": "Registers a student for an assessment administration. Identity is the assessment administration natural key (assigningEducationOrganizationSourcedId + assessment + administration) plus the student demographic natural key (studentSourcedId + educationOrganizationSourcedId). All education-organization legs are oneroster:org sourcedIds. Also requires an attending studentSchoolAssociation. Accommodations and customizations are folded jsonb collections."
    },
    {
      "name": "Student Assessment Registration Battery Part Association",
      "description": "Associates a student assessment registration with an assessment battery part, with optional accommodations (folded jsonb)."
    },
    {
      "name": "Student CTE Program Association",
      "description": "A subtype of generalStudentProgramAssociation representing a student's participation in a career and technical education (CTE) program. Same natural key shape: (studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Cohort Association",
      "description": "An association linking a student to a cohort. Records the student's membership in a specific cohort at an education organization with begin and optional end dates. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Competency Objective",
      "description": "A student's competency level for a competency objective in a grading period. Optional section or program association choice is folded as jsonb."
    },
    {
      "name": "Student Contact Association",
      "description": "An association linking a student to a contact/guardian. The student_sourced_id is a cross-module roster FK to oneroster:user.sourcedId, and contact_unique_id is an intra-domain FK to the Contact entity."
    },
    {
      "name": "Student Demographic",
      "description": "Student demographic information reported in an education organization context. Distinct from StudentEducationOrganizationAssociation in v6.1; used by Assessment Registration. Roster-anchored on student; education organization uses OneRoster org sourcedId. Inline collections folded to jsonb."
    },
    {
      "name": "Student Directory",
      "description": "Student directory contact information (addresses, emails, telephones) in an education organization context. Inline collections folded to jsonb."
    },
    {
      "name": "Student Discipline Incident Behavior Association",
      "description": "An association between a student and a specific behavior within a discipline incident, recording the student's involvement with a particular behavior."
    },
    {
      "name": "Student Discipline Incident Non-Offender Association",
      "description": "An association between a student and a discipline incident where the student is not an offender (e.g., victim, witness, or bystander)."
    },
    {
      "name": "Student Education Organization Assessment Accommodation",
      "description": "General assessment accommodations determined for a student by an education organization. Accommodation descriptors folded as jsonb array."
    },
    {
      "name": "Student Education Organization Association",
      "description": "This association represents a student's demographic and characteristic information as reported within an education organization context. It is a demographics-bearing association that carries student characteristics (sex, ethnicity, limited English proficiency, etc.) along with multi-valued collection children for addresses, telephones, electronic mails, races, languages, disabilities, student characteristics, and identification codes. The natural key is (studentSourcedId, educationOrganizationSourcedId). Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Education Organization Responsibility Association",
      "description": "This association indicates a relationship between a student and an education organization other than an enrollment relationship, and generally indicates a relationship such as accountability, guardianship, or other responsibility. The natural key includes responsibilityDescriptor and beginDate to allow multiple distinct responsibility relationships with effective-dated semantics."
    },
    {
      "name": "Student Gradebook Entry",
      "description": "A student's score or status for a gradebook entry."
    },
    {
      "name": "Student Health",
      "description": "Student health records. Natural key: (studentSourcedId, educationOrganizationSourcedId). asOfDate is required but not part of identity. Immunization commons are folded jsonb collections."
    },
    {
      "name": "Student Homeless Program Association",
      "description": "A subtype of generalStudentProgramAssociation representing a student's participation in a McKinney-Vento Homeless Program. Same natural key shape as the general association. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Identification Code",
      "description": "A coding scheme used to identify a student, discriminated by identification system and assigning organization."
    },
    {
      "name": "Student IEP",
      "description": "An Individualized Education Program (IEP) for a student receiving special education services. Roster-anchored on student; education organization uses OneRoster org sourcedId. Inline accommodations, disabilities, and IDEA event refs folded as jsonb."
    },
    {
      "name": "Student IEP Goal",
      "description": "A goal on a student IEP. FK to StudentIep via the 4-column composite natural key. Achievement period and IDEA event refs folded as jsonb."
    },
    {
      "name": "Student IEP Service Delivery",
      "description": "A delivered special education service against a student IEP. FK to StudentIep; optional prescription identity as plain scalars (command-layer). Providers and IDEA events folded as jsonb."
    },
    {
      "name": "Student IEP Service Prescription",
      "description": "A prescribed special education service on a student IEP. FK to StudentIep via composite natural key. IDEA events and staff refs folded as jsonb."
    },
    {
      "name": "Student Intervention Association",
      "description": "An association linking a student to an intervention program. Records the student's participation in a specific intervention at an education organization, including dosage and diagnostic information."
    },
    {
      "name": "Student Intervention Attendance Event",
      "description": "An attendance event recording a student's presence or absence at an intervention session. Captures the date, category, reason, and duration of the event."
    },
    {
      "name": "Student Language Instruction Program Association",
      "description": "A subtype of generalStudentProgramAssociation representing a student's participation in a Title III Language Instruction program. Same natural key shape as the general association. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Migrant Education Program Association",
      "description": "A subtype of generalStudentProgramAssociation representing a student's participation in a migrant education program. Requires priorityForServices and lastQualifyingMove beyond the general association fields. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Neglected Or Delinquent Program Association",
      "description": "A subtype of generalStudentProgramAssociation representing a student's participation in a Title I Part D Neglected or Delinquent program. Same natural key shape as the general association. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Path",
      "description": "Associates a student with a path of study. Periods folded as jsonb."
    },
    {
      "name": "Student Path Milestone Status",
      "description": "Status of a student's progress against a path milestone. Status events folded as jsonb."
    },
    {
      "name": "Student Path Phase Status",
      "description": "Status of a student's progress against a path phase. Status events and periods folded as jsonb."
    },
    {
      "name": "Student Program Association",
      "description": "A subtype of generalStudentProgramAssociation representing a generic program participation record when no more specific subtype applies. Shares the same natural key shape as the general association: (studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). The begin/end dates form the effective-dated history. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Program Attendance Event",
      "description": "Recording of whether a student is in attendance to receive or participate in program services. AttendanceEvent inline common is flattened onto the parent (fold rule). Natural key includes student, program composite key, eventDate, and attendanceEventCategoryDescriptor."
    },
    {
      "name": "Student Program Evaluation",
      "description": "The evaluation results for a student as evaluated in the context of a program. Natural key is the programEvaluation composite key plus student and evaluationDate. Objective/element rating commons are folded jsonb; nested entity FKs use title discriminators with command-layer validation."
    },
    {
      "name": "Student School Association",
      "description": "This association represents the school in which a student is enrolled. The semantics of enrollment may differ slightly by state. Non-enrollment relationships between a student and an education organization may be described using the StudentEducationOrganizationAssociation. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student School Attendance Event",
      "description": "A record of a student's attendance event at the school level for a given session and date. Links the student and school via OneRoster roster foreign keys."
    },
    {
      "name": "Student School Food Service Program Association",
      "description": "An association linking a student to a food service program, capturing eligibility and service details such as direct certification and meal program type. The student reference is a cross-module roster FK to oneroster:user.sourcedId."
    },
    {
      "name": "Student Section 504 Program Association",
      "description": "A subtype of generalStudentProgramAssociation identifying a student that qualifies for Section 504 of the Rehabilitation Act of 1973. Requires section504Eligibility. Same natural key shape as the general association. Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Section Association",
      "description": "An Ed-Fi student section association — a multi-base read/write view over `oneroster:enrollment` (primary) joined 1:1 to `edfi:studentSectionAssociationExtension` (owned companion) for enrollment rows of role \"student\". Roster-shared fields (student, class, school, dates) rename; Ed-Fi-only facts and collections live on the companion so they never ALTER onto the shared OneRoster enrollment master. Join presence is optional (LEFT JOIN): every extension field was nullable, so a bare roster enrollment remains visible with no companion row. Detail routes by a derived GUID. Updating a shared field also requires `edfi:write-shared`."
    },
    {
      "name": "Student Section Attendance Event",
      "description": "A record of a student's attendance event at the section level for a given date. This is the base entity that Alpha attendanceEvent projects from. The attendanceEventCategoryDescriptor maps to the Alpha projection's category field. Links the student, school, and class via OneRoster roster foreign keys."
    },
    {
      "name": "Student Special Education Program Association",
      "description": "A subtype of generalStudentProgramAssociation representing a student's participation in a special education program. Carries IDEA eligibility, special education setting, hours per week, IEP dates, and disability indicators beyond the general association's fields. Same natural key shape: (studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Special Education Program Eligibility Association",
      "description": "Captures details regarding the evaluation process for eligibility of students for special education services under IDEA Part C or Part B. Natural key: evaluating education organization, student, program composite key, and consentToEvaluationReceivedDate."
    },
    {
      "name": "Student Title I Part A Program Association",
      "description": "A subtype of generalStudentProgramAssociation representing a student's participation in a Title I Part A program. Carries the Title I Part A participant type beyond the general association's fields. Same natural key shape: (studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Inline Ed-Fi collections are stored as typed jsonb array properties on this table (inline Ed-Fi collections live as typed JSON arrays on this row)."
    },
    {
      "name": "Student Transportation",
      "description": "A record of a student's transportation arrangements to and from a school. The student and school references are cross-module roster FKs."
    },
    {
      "name": "Survey",
      "description": "A survey instrument administered to students, staff, or other stakeholders. Carries metadata about the survey including title, category, session, and administration counts."
    },
    {
      "name": "Survey Course Association",
      "description": "Associates a survey with a course. Course identity is (educationOrganizationId, courseCode) on the Ed-Fi wire; course rows live on oneroster:course."
    },
    {
      "name": "Survey Program Association",
      "description": "Associates a survey with a program."
    },
    {
      "name": "Survey Question",
      "description": "A question within a survey instrument. Each question has a code, form descriptor, text, and optionally belongs to a survey section."
    },
    {
      "name": "Survey Question Response",
      "description": "A respondent's answer to a specific survey question. Captures whether there was no response, and optionally a comment, numeric response, or text response."
    },
    {
      "name": "Survey Response",
      "description": "A response to a survey by a respondent. Links the survey to a response identifier and optionally to a student or staff member via roster FK. Surveys may be anonymous."
    },
    {
      "name": "Survey Response Education Organization Target Association",
      "description": "Associates a survey response with an education organization that is the target of the response. This allows responses to be directed at specific organizations."
    },
    {
      "name": "Survey Response Person Target Association",
      "description": "Associates a survey response with the person the survey is about."
    },
    {
      "name": "Survey Response Staff Target Association",
      "description": "Associates a survey response with the staff member the survey is about."
    },
    {
      "name": "Survey Section",
      "description": "A logical grouping of questions within a survey. Sections allow surveys to be organized into thematic or structural parts."
    },
    {
      "name": "Survey Section Aggregate Response",
      "description": "An aggregate survey section response linked to an evaluation element rating. FK to EvaluationElementRating and SurveySection."
    },
    {
      "name": "Survey Section Association",
      "description": "Associates a survey with a section (OneRoster class)."
    },
    {
      "name": "Survey Section Response",
      "description": "A respondent's answers aggregated at the survey section level. Links a survey response to a specific section and optionally captures a section-level rating."
    },
    {
      "name": "Survey Section Response Education Organization Target Association",
      "description": "Associates a survey section response with an education organization that is the target of the section-level response. This allows section responses to be directed at specific organizations."
    },
    {
      "name": "Survey Section Response Person Target Association",
      "description": "Associates a survey section response with the person the survey section is about."
    },
    {
      "name": "Survey Section Response Staff Target Association",
      "description": "Associates a survey section response with the staff member the survey section is about."
    }
  ],
  "paths": {
    "/ed-fi/academicWeeks": {
      "post": {
        "operationId": "createAcademicWeek",
        "summary": "Create a academic week",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Academic Week"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAcademicWeekRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AcademicWeek"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listAcademicWeeks",
        "summary": "List academic week records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Academic Week"
        ],
        "parameters": [
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by schoolSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "weekIdentifier",
            "in": "query",
            "description": "Filter by weekIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "weekIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AcademicWeek"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/academicWeeks/{id}": {
      "get": {
        "operationId": "getAcademicWeek",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Academic Week"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AcademicWeek"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (academic_week_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateAcademicWeek",
        "summary": "Update a academic week",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Academic Week"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAcademicWeekRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AcademicWeek"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (academic_week_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteAcademicWeek",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Academic Week"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (academic_week_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/accountabilityRatings": {
      "post": {
        "operationId": "createAccountabilityRating",
        "summary": "Create a accountability rating",
        "description": "Creates a accountability rating record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Accountability Rating"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAccountabilityRatingRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountabilityRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listAccountabilityRatings",
        "summary": "List accountability ratings",
        "description": "Lists accountability ratings with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Accountability Rating"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "ratingTitle",
            "in": "query",
            "description": "Filter by rating title.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "ratingTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AccountabilityRating"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/accountabilityRatings/{id}": {
      "get": {
        "operationId": "getAccountabilityRating",
        "summary": "Get a accountability rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Accountability Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountabilityRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateAccountabilityRating",
        "summary": "Update a accountability rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Accountability Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAccountabilityRatingRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountabilityRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteAccountabilityRating",
        "summary": "Delete a accountability rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Accountability Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/applicantProfiles": {
      "post": {
        "operationId": "createApplicantProfile",
        "summary": "Create a applicant profile",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Applicant Profile"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateApplicantProfileRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicantProfile"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listApplicantProfiles",
        "summary": "List applicant profile records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Applicant Profile"
        ],
        "parameters": [
          {
            "name": "applicantProfileIdentifier",
            "in": "query",
            "description": "Filter by applicantProfileIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "applicantProfileIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApplicantProfile"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/applicantProfiles/{id}": {
      "get": {
        "operationId": "getApplicantProfile",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Applicant Profile"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicantProfile"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (applicant_profile_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateApplicantProfile",
        "summary": "Update a applicant profile",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Applicant Profile"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateApplicantProfileRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicantProfile"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (applicant_profile_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteApplicantProfile",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Applicant Profile"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (applicant_profile_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/applications": {
      "post": {
        "operationId": "createApplication",
        "summary": "Create a application",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateApplicationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Application"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listApplications",
        "summary": "List application records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application"
        ],
        "parameters": [
          {
            "name": "applicationIdentifier",
            "in": "query",
            "description": "Filter by applicationIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "applicationIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "applicantProfileIdentifier",
            "in": "query",
            "description": "Filter by applicantProfileIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "applicantProfileIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Application"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/applications/{id}": {
      "get": {
        "operationId": "getApplication",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Application"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (application_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateApplication",
        "summary": "Update a application",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateApplicationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Application"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (application_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteApplication",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (application_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/applicationEvents": {
      "post": {
        "operationId": "createApplicationEvent",
        "summary": "Create a application event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateApplicationEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listApplicationEvents",
        "summary": "List application event records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application Event"
        ],
        "parameters": [
          {
            "name": "applicationIdentifier",
            "in": "query",
            "description": "Filter by applicationIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "applicationIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "applicantProfileIdentifier",
            "in": "query",
            "description": "Filter by applicantProfileIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "applicantProfileIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ApplicationEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/applicationEvents/{id}": {
      "get": {
        "operationId": "getApplicationEvent",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (application_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateApplicationEvent",
        "summary": "Update a application event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateApplicationEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApplicationEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (application_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteApplicationEvent",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Application Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (application_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessments": {
      "post": {
        "operationId": "createAssessment",
        "summary": "Create an assessment",
        "description": "Creates an Ed-Fi assessment record with metadata including category, version, and scoring information.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssessmentRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Assessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listAssessments",
        "summary": "List assessments",
        "description": "Lists assessment records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment"
        ],
        "parameters": [
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessment identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "assessmentCategoryDescriptor",
            "in": "query",
            "description": "Filter by assessment category.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentCategoryDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only assessments modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Assessment"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessments/{id}": {
      "get": {
        "operationId": "getAssessment",
        "summary": "Get an assessment by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Assessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateAssessment",
        "summary": "Update an assessment",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssessmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Assessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteAssessment",
        "summary": "Soft-delete an assessment",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Assessment soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentAdministrations": {
      "post": {
        "operationId": "createAssessmentAdministration",
        "summary": "Create a assessment administration",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssessmentAdministrationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentAdministration"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listAssessmentAdministrations",
        "summary": "List assessment administration records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration"
        ],
        "parameters": [
          {
            "name": "assigningEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by assigningEducationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assigningEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessmentIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssessmentAdministration"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentAdministrations/{id}": {
      "get": {
        "operationId": "getAssessmentAdministration",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentAdministration"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_administration_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateAssessmentAdministration",
        "summary": "Update a assessment administration",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssessmentAdministrationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentAdministration"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_administration_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteAssessmentAdministration",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_administration_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentAdministrationParticipations": {
      "post": {
        "operationId": "createAssessmentAdministrationParticipation",
        "summary": "Create a assessment administration participation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration Participation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssessmentAdministrationParticipationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentAdministrationParticipation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listAssessmentAdministrationParticipations",
        "summary": "List assessment administration participation records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration Participation"
        ],
        "parameters": [
          {
            "name": "assigningEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by assigningEducationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assigningEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessmentIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssessmentAdministrationParticipation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentAdministrationParticipations/{id}": {
      "get": {
        "operationId": "getAssessmentAdministrationParticipation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration Participation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentAdministrationParticipation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_administration_participation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateAssessmentAdministrationParticipation",
        "summary": "Update a assessment administration participation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration Participation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssessmentAdministrationParticipationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentAdministrationParticipation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_administration_participation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteAssessmentAdministrationParticipation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Administration Participation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_administration_participation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentBatteryParts": {
      "post": {
        "operationId": "createAssessmentBatteryPart",
        "summary": "Create a assessment battery part",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Battery Part"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssessmentBatteryPartRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentBatteryPart"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listAssessmentBatteryParts",
        "summary": "List assessment battery part records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Battery Part"
        ],
        "parameters": [
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessmentIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssessmentBatteryPart"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentBatteryParts/{id}": {
      "get": {
        "operationId": "getAssessmentBatteryPart",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Battery Part"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentBatteryPart"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_battery_part_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateAssessmentBatteryPart",
        "summary": "Update a assessment battery part",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Battery Part"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssessmentBatteryPartRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentBatteryPart"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_battery_part_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteAssessmentBatteryPart",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Battery Part"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_battery_part_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentItems": {
      "post": {
        "operationId": "createAssessmentItem",
        "summary": "Create an assessment item",
        "description": "Creates an individual question or task record belonging to an assessment.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Item"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssessmentItemRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentItem"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listAssessmentItems",
        "summary": "List assessment items",
        "description": "Lists assessment item records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Item"
        ],
        "parameters": [
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessment identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssessmentItem"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentItems/{id}": {
      "get": {
        "operationId": "getAssessmentItem",
        "summary": "Get an assessment item by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Item"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The assessment item's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentItem"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_item_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateAssessmentItem",
        "summary": "Update an assessment item",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Item"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The assessment item's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssessmentItemRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentItem"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_item_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteAssessmentItem",
        "summary": "Soft-delete an assessment item",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Item"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The assessment item's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Assessment item soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_item_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentScoreRangeLearningStandards": {
      "post": {
        "operationId": "createAssessmentScoreRangeLearningStandard",
        "summary": "Create a assessment score range learning standard",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Score Range Learning Standard"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssessmentScoreRangeLearningStandardRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentScoreRangeLearningStandard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listAssessmentScoreRangeLearningStandards",
        "summary": "List assessment score range learning standard records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Score Range Learning Standard"
        ],
        "parameters": [
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessmentIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssessmentScoreRangeLearningStandard"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/assessmentScoreRangeLearningStandards/{id}": {
      "get": {
        "operationId": "getAssessmentScoreRangeLearningStandard",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Score Range Learning Standard"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentScoreRangeLearningStandard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_score_range_learning_standard_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateAssessmentScoreRangeLearningStandard",
        "summary": "Update a assessment score range learning standard",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Score Range Learning Standard"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssessmentScoreRangeLearningStandardRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessmentScoreRangeLearningStandard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_score_range_learning_standard_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteAssessmentScoreRangeLearningStandard",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Assessment Score Range Learning Standard"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (assessment_score_range_learning_standard_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/balanceSheetDimensions": {
      "post": {
        "operationId": "createBalanceSheetDimension",
        "summary": "Create a balance sheet dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Balance Sheet Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBalanceSheetDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BalanceSheetDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listBalanceSheetDimensions",
        "summary": "List balance sheet dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Balance Sheet Dimension"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "description": "Filter by code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "code",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscalYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BalanceSheetDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/balanceSheetDimensions/{id}": {
      "get": {
        "operationId": "getBalanceSheetDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Balance Sheet Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BalanceSheetDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (balance_sheet_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateBalanceSheetDimension",
        "summary": "Update a balance sheet dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Balance Sheet Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateBalanceSheetDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BalanceSheetDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (balance_sheet_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteBalanceSheetDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Balance Sheet Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (balance_sheet_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/bellSchedules": {
      "get": {
        "operationId": "listBellSchedules",
        "summary": "List bell schedules",
        "description": "Returns all bell schedules for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Bell Schedule"
        ],
        "parameters": [
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only bell schedules modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BellSchedule"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createBellSchedule",
        "summary": "Create a bell schedule",
        "description": "Creates a new bell schedule record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Bell Schedule"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBellScheduleRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BellSchedule"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/bellSchedules/{id}": {
      "get": {
        "operationId": "getBellSchedule",
        "summary": "Get a bell schedule",
        "description": "Returns a single bell schedule by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Bell Schedule"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The bell schedule's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BellSchedule"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (bell_schedule_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateBellSchedule",
        "summary": "Update a bell schedule",
        "description": "Updates mutable fields of a bell schedule record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Bell Schedule"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The bell schedule's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateBellScheduleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BellSchedule"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (bell_schedule_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteBellSchedule",
        "summary": "Delete a bell schedule",
        "description": "Soft-deletes a bell schedule record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Bell Schedule"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The bell schedule's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Bell schedule soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (bell_schedule_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/calendars": {
      "get": {
        "operationId": "listCalendars",
        "summary": "List calendars",
        "description": "Returns all calendars for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar"
        ],
        "parameters": [
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "calendarTypeDescriptor",
            "in": "query",
            "description": "Filter by calendar type descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "calendarTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only calendars modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Calendar"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createCalendar",
        "summary": "Create a calendar",
        "description": "Creates a new calendar for a school and school year.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCalendarRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Calendar"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/calendars/{id}": {
      "get": {
        "operationId": "getCalendar",
        "summary": "Get a calendar",
        "description": "Returns a single calendar by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Calendar"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCalendar",
        "summary": "Update a calendar",
        "description": "Updates mutable fields of a calendar record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCalendarRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Calendar"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCalendar",
        "summary": "Delete a calendar",
        "description": "Soft-deletes a calendar record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Calendar soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/calendarDates": {
      "get": {
        "operationId": "listCalendarDates",
        "summary": "List calendar dates",
        "description": "Returns all calendar dates for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date"
        ],
        "parameters": [
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "date",
            "in": "query",
            "description": "Filter by specific date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "date",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only calendar dates modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CalendarDate"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createCalendarDate",
        "summary": "Create a calendar date",
        "description": "Creates a new calendar date entry within a calendar.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCalendarDateRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarDate"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/calendarDates/{id}": {
      "get": {
        "operationId": "getCalendarDate",
        "summary": "Get a calendar date",
        "description": "Returns a single calendar date by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar date's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarDate"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_date_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCalendarDate",
        "summary": "Update a calendar date",
        "description": "Updates mutable fields of a calendar date record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar date's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCalendarDateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarDate"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_date_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCalendarDate",
        "summary": "Delete a calendar date",
        "description": "Soft-deletes a calendar date record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar date's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Calendar date soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_date_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/calendarDateCalendarEvents": {
      "get": {
        "operationId": "listCalendarDateCalendarEvents",
        "summary": "List calendar date events",
        "description": "Returns all calendar events for a calendar date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date Calendar Event"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CalendarDateCalendarEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createCalendarDateCalendarEvent",
        "summary": "Create a calendar date event",
        "description": "Creates a new calendar event on a calendar date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date Calendar Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCalendarDateCalendarEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarDateCalendarEvent"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/calendarDateCalendarEvents/{id}": {
      "get": {
        "operationId": "getCalendarDateCalendarEvent",
        "summary": "Get a calendar date event",
        "description": "Returns a single calendar date event by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date Calendar Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarDateCalendarEvent"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_date_calendar_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCalendarDateCalendarEvent",
        "summary": "Update a calendar date event",
        "description": "Updates a calendar date event record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date Calendar Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCalendarDateCalendarEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarDateCalendarEvent"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_date_calendar_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCalendarDateCalendarEvent",
        "summary": "Delete a calendar date event",
        "description": "Soft-deletes a calendar date event record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Calendar Date Calendar Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The calendar event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Calendar date event soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (calendar_date_calendar_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/candidates": {
      "post": {
        "operationId": "createCandidate",
        "summary": "Create a candidate",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCandidateRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Candidate"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCandidates",
        "summary": "List candidate records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate"
        ],
        "parameters": [
          {
            "name": "candidateIdentifier",
            "in": "query",
            "description": "Filter by candidateIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "candidateIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Candidate"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/candidates/{id}": {
      "get": {
        "operationId": "getCandidate",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Candidate"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCandidate",
        "summary": "Update a candidate",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCandidateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Candidate"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCandidate",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/candidateEducatorPreparationProgramAssociations": {
      "post": {
        "operationId": "createCandidateEducatorPreparationProgramAssociation",
        "summary": "Create a candidate educator preparation program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Educator Preparation Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCandidateEducatorPreparationProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateEducatorPreparationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCandidateEducatorPreparationProgramAssociations",
        "summary": "List candidate educator preparation program association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Educator Preparation Program Association"
        ],
        "parameters": [
          {
            "name": "candidateIdentifier",
            "in": "query",
            "description": "Filter by candidateIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "candidateIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by programName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CandidateEducatorPreparationProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/candidateEducatorPreparationProgramAssociations/{id}": {
      "get": {
        "operationId": "getCandidateEducatorPreparationProgramAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Educator Preparation Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateEducatorPreparationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_educator_preparation_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCandidateEducatorPreparationProgramAssociation",
        "summary": "Update a candidate educator preparation program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Educator Preparation Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCandidateEducatorPreparationProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateEducatorPreparationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_educator_preparation_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCandidateEducatorPreparationProgramAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Educator Preparation Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_educator_preparation_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/candidateIdentificationCodes": {
      "post": {
        "operationId": "createCandidateIdentificationCode",
        "summary": "Create a candidate identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Identification Code"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCandidateIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCandidateIdentificationCodes",
        "summary": "List candidate identification code records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Identification Code"
        ],
        "parameters": [
          {
            "name": "candidateIdentifier",
            "in": "query",
            "description": "Filter by candidateIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "candidateIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CandidateIdentificationCode"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/candidateIdentificationCodes/{id}": {
      "get": {
        "operationId": "getCandidateIdentificationCode",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCandidateIdentificationCode",
        "summary": "Update a candidate identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCandidateIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCandidateIdentificationCode",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/candidateRelationshipToStaffAssociations": {
      "post": {
        "operationId": "createCandidateRelationshipToStaffAssociation",
        "summary": "Create a candidate relationship to staff association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Relationship To Staff Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCandidateRelationshipToStaffAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateRelationshipToStaffAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCandidateRelationshipToStaffAssociations",
        "summary": "List candidate relationship to staff association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Relationship To Staff Association"
        ],
        "parameters": [
          {
            "name": "candidateIdentifier",
            "in": "query",
            "description": "Filter by candidateIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "candidateIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staffSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CandidateRelationshipToStaffAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/candidateRelationshipToStaffAssociations/{id}": {
      "get": {
        "operationId": "getCandidateRelationshipToStaffAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Relationship To Staff Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateRelationshipToStaffAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_relationship_to_staff_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCandidateRelationshipToStaffAssociation",
        "summary": "Update a candidate relationship to staff association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Relationship To Staff Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCandidateRelationshipToStaffAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateRelationshipToStaffAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_relationship_to_staff_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCandidateRelationshipToStaffAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Candidate Relationship To Staff Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (candidate_relationship_to_staff_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/certifications": {
      "post": {
        "operationId": "createCertification",
        "summary": "Create a certification",
        "description": "Creates a certification record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCertificationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Certification"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCertifications",
        "summary": "List certifications",
        "description": "Lists certifications with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification"
        ],
        "parameters": [
          {
            "name": "certificationIdentifier",
            "in": "query",
            "description": "Filter by certification identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "certificationIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Certification"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/certifications/{id}": {
      "get": {
        "operationId": "getCertification",
        "summary": "Get a certification",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Certification"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCertification",
        "summary": "Update a certification",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCertificationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Certification"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCertification",
        "summary": "Delete a certification",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/certificationExams": {
      "post": {
        "operationId": "createCertificationExam",
        "summary": "Create a certification exam",
        "description": "Creates a certification exam record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCertificationExamRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificationExam"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCertificationExams",
        "summary": "List certification exams",
        "description": "Lists certification exams with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam"
        ],
        "parameters": [
          {
            "name": "certificationExamIdentifier",
            "in": "query",
            "description": "Filter by certification exam identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "certificationExamIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CertificationExam"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/certificationExams/{id}": {
      "get": {
        "operationId": "getCertificationExam",
        "summary": "Get a certification exam",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificationExam"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCertificationExam",
        "summary": "Update a certification exam",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCertificationExamRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificationExam"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCertificationExam",
        "summary": "Delete a certification exam",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/certificationExamResults": {
      "post": {
        "operationId": "createCertificationExamResult",
        "summary": "Create a certification exam result",
        "description": "Creates a certification exam result record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam Result"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCertificationExamResultRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificationExamResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCertificationExamResults",
        "summary": "List certification exam results",
        "description": "Lists certification exam results with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam Result"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by person id.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "certificationExamIdentifier",
            "in": "query",
            "description": "Filter by certification exam identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "certificationExamIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "certificationExamDate",
            "in": "query",
            "description": "Filter by exam date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "certificationExamDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CertificationExamResult"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/certificationExamResults/{id}": {
      "get": {
        "operationId": "getCertificationExamResult",
        "summary": "Get a certification exam result",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam Result"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificationExamResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCertificationExamResult",
        "summary": "Update a certification exam result",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam Result"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCertificationExamResultRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificationExamResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCertificationExamResult",
        "summary": "Delete a certification exam result",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Certification Exam Result"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/chartOfAccounts": {
      "post": {
        "operationId": "createChartOfAccount",
        "summary": "Create an account",
        "description": "Creates an Ed-Fi financial account record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Chart of Account"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChartOfAccountRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChartOfAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listChartOfAccounts",
        "summary": "List accounts",
        "description": "Lists financial account records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Chart of Account"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscal year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ChartOfAccount"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/chartOfAccounts/{id}": {
      "get": {
        "operationId": "getChartOfAccount",
        "summary": "Get an account by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Chart of Account"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChartOfAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (chart_of_account_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateChartOfAccount",
        "summary": "Update an account",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Chart of Account"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateChartOfAccountRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChartOfAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (chart_of_account_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteChartOfAccount",
        "summary": "Soft-delete an account",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Chart of Account"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "ChartOfAccount soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (chart_of_account_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/classPeriods": {
      "get": {
        "operationId": "listClassPeriods",
        "summary": "List class periods",
        "description": "Returns all class periods for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Class Period"
        ],
        "parameters": [
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only class periods modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ClassPeriod"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createClassPeriod",
        "summary": "Create a class period",
        "description": "Creates a new class period record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Class Period"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateClassPeriodRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClassPeriod"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/classPeriods/{id}": {
      "get": {
        "operationId": "getClassPeriod",
        "summary": "Get a class period",
        "description": "Returns a single class period by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Class Period"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The class period's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClassPeriod"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (class_period_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateClassPeriod",
        "summary": "Update a class period",
        "description": "Updates mutable fields of a class period record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Class Period"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The class period's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateClassPeriodRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClassPeriod"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (class_period_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteClassPeriod",
        "summary": "Delete a class period",
        "description": "Soft-deletes a class period record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Class Period"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The class period's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Class period soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (class_period_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/cohorts": {
      "post": {
        "operationId": "createCohort",
        "summary": "Create a cohort",
        "description": "Creates an Ed-Fi cohort record defining a group of students organized for a common purpose.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Cohort"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCohortRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Cohort"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCohorts",
        "summary": "List cohorts",
        "description": "Lists cohort records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Cohort"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "cohortTypeDescriptor",
            "in": "query",
            "description": "Filter by cohort type.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "cohortTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only cohorts modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Cohort"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/cohorts/{id}": {
      "get": {
        "operationId": "getCohort",
        "summary": "Get a cohort by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Cohort"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The cohort's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Cohort"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (cohort_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCohort",
        "summary": "Update a cohort",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Cohort"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The cohort's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCohortRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Cohort"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (cohort_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCohort",
        "summary": "Soft-delete a cohort",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Cohort"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The cohort's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Cohort soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (cohort_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/communityOrganizations": {
      "post": {
        "operationId": "createCommunityOrganization",
        "summary": "Create a community organization",
        "description": "Creates a community organization record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Organization"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCommunityOrganizationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityOrganization"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCommunityOrganizations",
        "summary": "List community organizations",
        "description": "Lists community organization records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Organization"
        ],
        "parameters": [
          {
            "name": "communityOrganizationId",
            "in": "query",
            "description": "Filter by community organization identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "communityOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "nameOfInstitution",
            "in": "query",
            "description": "Filter by institution name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "nameOfInstitution",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CommunityOrganization"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/communityOrganizations/{id}": {
      "get": {
        "operationId": "getCommunityOrganization",
        "summary": "Get a community organization by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Organization"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The community organization's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityOrganization"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_organization_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCommunityOrganization",
        "summary": "Update a community organization",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Organization"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The community organization's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCommunityOrganizationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityOrganization"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_organization_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCommunityOrganization",
        "summary": "Soft-delete a community organization",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Organization"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The community organization's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Community organization soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_organization_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/communityProviders": {
      "post": {
        "operationId": "createCommunityProvider",
        "summary": "Create a community provider",
        "description": "Creates a community provider record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCommunityProviderRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityProvider"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCommunityProviders",
        "summary": "List community providers",
        "description": "Lists community provider records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider"
        ],
        "parameters": [
          {
            "name": "communityProviderId",
            "in": "query",
            "description": "Filter by community provider identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "communityProviderId",
              "operator": "eq"
            }
          },
          {
            "name": "communityOrganizationId",
            "in": "query",
            "description": "Filter by community organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "communityOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "providerCategoryDescriptor",
            "in": "query",
            "description": "Filter by provider category.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "providerCategoryDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CommunityProvider"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/communityProviders/{id}": {
      "get": {
        "operationId": "getCommunityProvider",
        "summary": "Get a community provider by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The community provider's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityProvider"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_provider_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCommunityProvider",
        "summary": "Update a community provider",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The community provider's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCommunityProviderRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityProvider"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_provider_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCommunityProvider",
        "summary": "Soft-delete a community provider",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The community provider's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Community provider soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_provider_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/communityProviderLicenses": {
      "post": {
        "operationId": "createCommunityProviderLicense",
        "summary": "Create a community provider license",
        "description": "Creates a license record for a community provider.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider License"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCommunityProviderLicenseRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityProviderLicense"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCommunityProviderLicenses",
        "summary": "List community provider licenses",
        "description": "Lists community provider license records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider License"
        ],
        "parameters": [
          {
            "name": "communityProviderId",
            "in": "query",
            "description": "Filter by community provider.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "communityProviderId",
              "operator": "eq"
            }
          },
          {
            "name": "licensingOrganization",
            "in": "query",
            "description": "Filter by licensing organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "licensingOrganization",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CommunityProviderLicense"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/communityProviderLicenses/{id}": {
      "get": {
        "operationId": "getCommunityProviderLicense",
        "summary": "Get a community provider license by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider License"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The license's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityProviderLicense"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_provider_license_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCommunityProviderLicense",
        "summary": "Update a community provider license",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider License"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The license's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCommunityProviderLicenseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunityProviderLicense"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_provider_license_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCommunityProviderLicense",
        "summary": "Soft-delete a community provider license",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Community Provider License"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The license's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Community provider license soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (community_provider_license_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/competencyObjectives": {
      "post": {
        "operationId": "createCompetencyObjective",
        "summary": "Create a competency objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Competency Objective"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCompetencyObjectiveRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompetencyObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCompetencyObjectives",
        "summary": "List competency objectives",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Competency Objective"
        ],
        "parameters": [
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "objectiveGradeLevelDescriptor",
            "in": "query",
            "description": "Filter by grade level.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "objectiveGradeLevelDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CompetencyObjective"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/competencyObjectives/{id}": {
      "get": {
        "operationId": "getCompetencyObjective",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Competency Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompetencyObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (competency_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCompetencyObjective",
        "summary": "Update a competency objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Competency Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCompetencyObjectiveRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompetencyObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (competency_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCompetencyObjective",
        "summary": "Soft-delete a competency objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Competency Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (competency_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/conformance/evidence": {
      "post": {
        "operationId": "createConformanceEvidence",
        "summary": "Create conformance evidence",
        "description": "Generates and stores a new conformance evidence record proving UDM coverage, descriptor governance, or roster-boundary compliance.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Conformance evidence"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateConformanceEvidenceRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConformanceEvidence"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listConformanceEvidence",
        "summary": "List conformance evidence",
        "description": "Lists conformance evidence records, optionally filtered by evidence type.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Conformance evidence"
        ],
        "parameters": [
          {
            "name": "evidenceType",
            "in": "query",
            "description": "Filter by evidence type.",
            "schema": {
              "type": "string",
              "enum": [
                "udm_coverage",
                "descriptor_governance",
                "roster_boundary"
              ]
            },
            "x-filter": {
              "column": "evidenceType",
              "operator": "eq"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 50, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ConformanceEvidence"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/conformance/evidence/{id}": {
      "get": {
        "operationId": "getConformanceEvidence",
        "summary": "Get conformance evidence",
        "description": "Returns one conformance evidence record by its id.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Conformance evidence"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The conformance evidence id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConformanceEvidence"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (conformance_evidence_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/contacts": {
      "post": {
        "operationId": "createContact",
        "summary": "Create a contact",
        "description": "Creates an Ed-Fi contact demographic record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateContactRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Contact"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listContacts",
        "summary": "List contacts",
        "description": "Lists contact demographic records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact"
        ],
        "parameters": [
          {
            "name": "lastSurname",
            "in": "query",
            "description": "Filter by last surname.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "lastSurname",
              "operator": "eq"
            }
          },
          {
            "name": "firstName",
            "in": "query",
            "description": "Filter by first name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "firstName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only contacts modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Contact"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/contacts/{id}": {
      "get": {
        "operationId": "getContact",
        "summary": "Get a contact by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The contact's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Contact"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (contact_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateContact",
        "summary": "Update a contact",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The contact's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateContactRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Contact"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (contact_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteContact",
        "summary": "Soft-delete a contact",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The contact's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Contact soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (contact_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/contactIdentificationCodes": {
      "post": {
        "operationId": "createContactIdentificationCode",
        "summary": "Create a contact identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact Identification Code"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateContactIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContactIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listContactIdentificationCodes",
        "summary": "List contact identification code records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact Identification Code"
        ],
        "parameters": [
          {
            "name": "contactUniqueId",
            "in": "query",
            "description": "Filter by contactUniqueId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "contactUniqueId",
              "operator": "eq"
            }
          },
          {
            "name": "contactIdentificationSystemDescriptor",
            "in": "query",
            "description": "Filter by contactIdentificationSystemDescriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "contactIdentificationSystemDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ContactIdentificationCode"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/contactIdentificationCodes/{id}": {
      "get": {
        "operationId": "getContactIdentificationCode",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContactIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (contact_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateContactIdentificationCode",
        "summary": "Update a contact identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateContactIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContactIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (contact_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteContactIdentificationCode",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Contact Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (contact_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/courses": {
      "post": {
        "operationId": "createCourse",
        "summary": "Create a course",
        "description": "Creates an Ed-Fi course by writing through into the oneroster:course master. Shared roster fields are written on CREATE; subsequent UPDATE of shared fields requires edfi:write-shared.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCourseRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Course"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCourses",
        "summary": "List courses",
        "description": "Lists course records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "courseCode",
            "in": "query",
            "description": "Filter by course code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "courseCode",
              "operator": "eq"
            }
          },
          {
            "name": "courseTitle",
            "in": "query",
            "description": "Filter by course title.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "courseTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only courses modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Course"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/courses/{id}": {
      "get": {
        "operationId": "getCourse",
        "summary": "Get a course by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The course's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Course"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCourse",
        "summary": "Update a course",
        "description": "Updates Ed-Fi-owned extends fields. Shared roster fields (courseTitle, courseCode, educationOrganizationId) require edfi:write-shared.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The course's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCourseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Course"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCourse",
        "summary": "Delete a course",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The course's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Course deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/courseOfferings": {
      "post": {
        "operationId": "createCourseOffering",
        "summary": "Create a course offering",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Offering"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCourseOfferingRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourseOffering"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCourseOfferings",
        "summary": "List course offerings",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Offering"
        ],
        "parameters": [
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "localCourseCode",
            "in": "query",
            "description": "Filter by local course code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "localCourseCode",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "sessionName",
            "in": "query",
            "description": "Filter by session name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "sessionName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CourseOffering"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/courseOfferings/{id}": {
      "get": {
        "operationId": "getCourseOffering",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Offering"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourseOffering"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_offering_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCourseOffering",
        "summary": "Update",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Offering"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCourseOfferingRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourseOffering"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_offering_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCourseOffering",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Offering"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_offering_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/courseTranscripts": {
      "post": {
        "operationId": "createCourseTranscript",
        "summary": "Create a course transcript",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Transcript"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCourseTranscriptRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourseTranscript"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCourseTranscripts",
        "summary": "List course transcripts",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Transcript"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "courseCode",
            "in": "query",
            "description": "Filter by course code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "courseCode",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CourseTranscript"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/courseTranscripts/{id}": {
      "get": {
        "operationId": "getCourseTranscript",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Transcript"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourseTranscript"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_transcript_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCourseTranscript",
        "summary": "Update",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Transcript"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCourseTranscriptRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CourseTranscript"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_transcript_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCourseTranscript",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Course Transcript"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (course_transcript_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/credentials": {
      "post": {
        "operationId": "createCredential",
        "summary": "Create a credential",
        "description": "Creates a credential record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCredentialRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Credential"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCredentials",
        "summary": "List credentials",
        "description": "Lists credentials with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential"
        ],
        "parameters": [
          {
            "name": "credentialIdentifier",
            "in": "query",
            "description": "Filter by credential identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "credentialIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "stateOfIssueStateAbbreviationDescriptor",
            "in": "query",
            "description": "Filter by state of issue.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "stateOfIssueStateAbbreviationDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by person id.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Credential"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/credentials/{id}": {
      "get": {
        "operationId": "getCredential",
        "summary": "Get a credential",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Credential"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCredential",
        "summary": "Update a credential",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCredentialRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Credential"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCredential",
        "summary": "Delete a credential",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/credentialEvents": {
      "post": {
        "operationId": "createCredentialEvent",
        "summary": "Create a credential event",
        "description": "Creates a credential event record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCredentialEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCredentialEvents",
        "summary": "List credential events",
        "description": "Lists credential events with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential Event"
        ],
        "parameters": [
          {
            "name": "credentialIdentifier",
            "in": "query",
            "description": "Filter by credential identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "credentialIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "credentialEventDate",
            "in": "query",
            "description": "Filter by event date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "credentialEventDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CredentialEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/credentialEvents/{id}": {
      "get": {
        "operationId": "getCredentialEvent",
        "summary": "Get a credential event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCredentialEvent",
        "summary": "Update a credential event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCredentialEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCredentialEvent",
        "summary": "Delete a credential event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Credential Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/crisisEvents": {
      "post": {
        "operationId": "createCrisisEvent",
        "summary": "Create a crisis event",
        "description": "Creates a crisis event record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Crisis Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCrisisEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CrisisEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listCrisisEvents",
        "summary": "List crisis events",
        "description": "Lists crisis events with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Crisis Event"
        ],
        "parameters": [
          {
            "name": "crisisEventName",
            "in": "query",
            "description": "Filter by crisis event name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "crisisEventName",
              "operator": "eq"
            }
          },
          {
            "name": "crisisTypeDescriptor",
            "in": "query",
            "description": "Filter by crisis type.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "crisisTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CrisisEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/crisisEvents/{id}": {
      "get": {
        "operationId": "getCrisisEvent",
        "summary": "Get a crisis event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Crisis Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CrisisEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateCrisisEvent",
        "summary": "Update a crisis event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Crisis Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCrisisEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CrisisEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteCrisisEvent",
        "summary": "Delete a crisis event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Crisis Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/descriptors": {
      "post": {
        "operationId": "createDescriptor",
        "summary": "Create a descriptor",
        "description": "Creates a governed descriptor value in the registry. The descriptor type must be a recognized Ed-Fi descriptor type.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDescriptorRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Descriptor"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listDescriptors",
        "summary": "List descriptors",
        "description": "Lists governed descriptor values, optionally filtered by type, namespace, or standard status.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor"
        ],
        "parameters": [
          {
            "name": "descriptorType",
            "in": "query",
            "description": "Filter by descriptor type.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "descriptorType",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace URI.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "standardStatus",
            "in": "query",
            "description": "Filter by governance tier.",
            "schema": {
              "type": "string",
              "enum": [
                "ed_fi_standard",
                "district_local",
                "platform_extension"
              ]
            },
            "x-filter": {
              "column": "standardStatus",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only descriptors modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Descriptor"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/descriptors/{id}": {
      "get": {
        "operationId": "getDescriptor",
        "summary": "Get a descriptor",
        "description": "Returns one descriptor value by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The descriptor's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Descriptor"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (descriptor_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateDescriptor",
        "summary": "Update a descriptor",
        "description": "Updates mutable fields of a governed descriptor value.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The descriptor's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateDescriptorRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Descriptor"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (descriptor_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteDescriptor",
        "summary": "Delete a descriptor",
        "description": "Soft-deletes a governed descriptor value from the registry.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The descriptor's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Descriptor soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (descriptor_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/descriptorMappings": {
      "post": {
        "operationId": "createDescriptorMapping",
        "summary": "Create a descriptor mapping",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor Mapping"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDescriptorMappingRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DescriptorMapping"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listDescriptorMappings",
        "summary": "List descriptor mapping records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor Mapping"
        ],
        "parameters": [
          {
            "name": "value",
            "in": "query",
            "description": "Filter by value.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "value",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DescriptorMapping"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/descriptorMappings/{id}": {
      "get": {
        "operationId": "getDescriptorMapping",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor Mapping"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DescriptorMapping"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (descriptor_mapping_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateDescriptorMapping",
        "summary": "Update a descriptor mapping",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor Mapping"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateDescriptorMappingRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DescriptorMapping"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (descriptor_mapping_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteDescriptorMapping",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Descriptor Mapping"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (descriptor_mapping_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/disciplineActions": {
      "post": {
        "operationId": "createDisciplineAction",
        "summary": "Create a discipline action",
        "description": "Creates a new discipline action record for a student.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Action"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDisciplineActionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisciplineAction"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listDisciplineActions",
        "summary": "List discipline actions",
        "description": "Lists discipline actions with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Action"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "assignedSchoolSourcedId",
            "in": "query",
            "description": "Filter by assigned school.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assignedSchoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "disciplineDate",
            "in": "query",
            "description": "Filter by discipline date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "disciplineDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DisciplineAction"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/disciplineActions/{id}": {
      "get": {
        "operationId": "getDisciplineAction",
        "summary": "Get a discipline action by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Action"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The discipline action's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisciplineAction"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (discipline_action_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateDisciplineAction",
        "summary": "Update a discipline action",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Action"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The discipline action's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateDisciplineActionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisciplineAction"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (discipline_action_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteDisciplineAction",
        "summary": "Soft-delete a discipline action",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Action"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The discipline action's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Discipline action soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (discipline_action_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/disciplineIncidents": {
      "post": {
        "operationId": "createDisciplineIncident",
        "summary": "Create a discipline incident",
        "description": "Creates a new discipline incident record for a school.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Incident"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDisciplineIncidentRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisciplineIncident"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listDisciplineIncidents",
        "summary": "List discipline incidents",
        "description": "Lists discipline incidents with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Incident"
        ],
        "parameters": [
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "incidentDate",
            "in": "query",
            "description": "Filter by incident date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "incidentDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DisciplineIncident"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/disciplineIncidents/{id}": {
      "get": {
        "operationId": "getDisciplineIncident",
        "summary": "Get a discipline incident by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Incident"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The discipline incident's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisciplineIncident"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (discipline_incident_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateDisciplineIncident",
        "summary": "Update a discipline incident",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Incident"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The discipline incident's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateDisciplineIncidentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DisciplineIncident"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (discipline_incident_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteDisciplineIncident",
        "summary": "Soft-delete a discipline incident",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Discipline Incident"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The discipline incident's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Discipline incident soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (discipline_incident_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/drafts": {
      "post": {
        "operationId": "createEdfiDraftRecord",
        "summary": "Create a draft record",
        "description": "Stores a pre-canonical draft of an Ed-Fi resource. The draft does not satisfy any references until promoted.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Ed-Fi draft record"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEdfiDraftRecordRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EdfiDraftRecord"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEdfiDraftRecords",
        "summary": "List draft records",
        "description": "Lists Ed-Fi draft records, optionally filtered by resource type or state.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Ed-Fi draft record"
        ],
        "parameters": [
          {
            "name": "resourceType",
            "in": "query",
            "description": "Filter by the Ed-Fi resource type of the draft.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "resourceType",
              "operator": "eq"
            }
          },
          {
            "name": "recordState",
            "in": "query",
            "description": "Filter by record lifecycle state.",
            "schema": {
              "type": "string",
              "enum": [
                "draft",
                "canonical",
                "rejected",
                "soft_deleted"
              ]
            },
            "x-filter": {
              "column": "recordState",
              "operator": "eq"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 50, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EdfiDraftRecord"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/drafts/{id}": {
      "get": {
        "operationId": "getEdfiDraftRecord",
        "summary": "Get a draft record",
        "description": "Returns one draft record by its id.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Ed-Fi draft record"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The draft record id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EdfiDraftRecord"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (draft_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationContents": {
      "post": {
        "operationId": "createEducationContent",
        "summary": "Create an education content",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Content"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducationContentRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationContent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEducationContents",
        "summary": "List education contents",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Content"
        ],
        "parameters": [
          {
            "name": "contentIdentifier",
            "in": "query",
            "description": "Filter by content identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "contentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducationContent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationContents/{id}": {
      "get": {
        "operationId": "getEducationContent",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Content"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationContent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_content_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducationContent",
        "summary": "Update an education content",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Content"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducationContentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationContent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_content_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducationContent",
        "summary": "Soft-delete an education content",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Content"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_content_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizations": {
      "post": {
        "operationId": "createEducationOrganization",
        "summary": "Create a education organization",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducationOrganizationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganization"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEducationOrganizations",
        "summary": "List education organization records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by educationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "nameOfInstitution",
            "in": "query",
            "description": "Filter by nameOfInstitution.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "nameOfInstitution",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducationOrganization"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizations/{id}": {
      "get": {
        "operationId": "getEducationOrganization",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganization"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducationOrganization",
        "summary": "Update a education organization",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducationOrganizationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganization"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducationOrganization",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationIdentificationCodes": {
      "post": {
        "operationId": "createEducationOrganizationIdentificationCode",
        "summary": "Create a education organization identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Identification Code"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducationOrganizationIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEducationOrganizationIdentificationCodes",
        "summary": "List education organization identification code records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Identification Code"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationIdentificationSystemDescriptor",
            "in": "query",
            "description": "Filter by educationOrganizationIdentificationSystemDescriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationIdentificationSystemDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducationOrganizationIdentificationCode"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationIdentificationCodes/{id}": {
      "get": {
        "operationId": "getEducationOrganizationIdentificationCode",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducationOrganizationIdentificationCode",
        "summary": "Update a education organization identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducationOrganizationIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducationOrganizationIdentificationCode",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationInterventionPrescriptionAssociations": {
      "post": {
        "operationId": "createEducationOrganizationInterventionPrescriptionAssociation",
        "summary": "Create a education organization intervention prescription association",
        "description": "Creates a education organization intervention prescription association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Intervention Prescription Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducationOrganizationInterventionPrescriptionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationInterventionPrescriptionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEducationOrganizationInterventionPrescriptionAssociations",
        "summary": "List education organization intervention prescription associations",
        "description": "Lists education organization intervention prescription associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Intervention Prescription Association"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "interventionPrescriptionIdentificationCode",
            "in": "query",
            "description": "Filter by intervention prescription identification code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "interventionPrescriptionIdentificationCode",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducationOrganizationInterventionPrescriptionAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationInterventionPrescriptionAssociations/{id}": {
      "get": {
        "operationId": "getEducationOrganizationInterventionPrescriptionAssociation",
        "summary": "Get a education organization intervention prescription association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Intervention Prescription Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationInterventionPrescriptionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducationOrganizationInterventionPrescriptionAssociation",
        "summary": "Update a education organization intervention prescription association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Intervention Prescription Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducationOrganizationInterventionPrescriptionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationInterventionPrescriptionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducationOrganizationInterventionPrescriptionAssociation",
        "summary": "Delete a education organization intervention prescription association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Intervention Prescription Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationNetworks": {
      "get": {
        "operationId": "listEducationOrganizationNetworks",
        "summary": "List education organization networks",
        "description": "Returns all education organization networks for the authenticated tenant.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network"
        ],
        "parameters": [
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducationOrganizationNetwork"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createEducationOrganizationNetwork",
        "summary": "Create an education organization network",
        "description": "Creates a new education organization network record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducationOrganizationNetworkRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationNetwork"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationNetworks/{id}": {
      "get": {
        "operationId": "getEducationOrganizationNetwork",
        "summary": "Get an education organization network",
        "description": "Returns a single education organization network by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The network's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationNetwork"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_network_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducationOrganizationNetwork",
        "summary": "Update an education organization network",
        "description": "Updates mutable fields of an education organization network record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The network's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducationOrganizationNetworkRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationNetwork"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_network_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducationOrganizationNetwork",
        "summary": "Delete an education organization network",
        "description": "Soft-deletes an education organization network record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The network's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Education organization network soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_network_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationNetworkAssociations": {
      "post": {
        "operationId": "createEducationOrganizationNetworkAssociation",
        "summary": "Create a education organization network association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducationOrganizationNetworkAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationNetworkAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEducationOrganizationNetworkAssociations",
        "summary": "List education organization network association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network Association"
        ],
        "parameters": [
          {
            "name": "educationOrganizationNetworkId",
            "in": "query",
            "description": "Filter by educationOrganizationNetworkId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationNetworkId",
              "operator": "eq"
            }
          },
          {
            "name": "memberEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by memberEducationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "memberEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducationOrganizationNetworkAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationNetworkAssociations/{id}": {
      "get": {
        "operationId": "getEducationOrganizationNetworkAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationNetworkAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_network_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducationOrganizationNetworkAssociation",
        "summary": "Update a education organization network association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducationOrganizationNetworkAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationNetworkAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_network_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducationOrganizationNetworkAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Network Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_network_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationPeerAssociations": {
      "post": {
        "operationId": "createEducationOrganizationPeerAssociation",
        "summary": "Create a education organization peer association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Peer Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducationOrganizationPeerAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationPeerAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEducationOrganizationPeerAssociations",
        "summary": "List education organization peer association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Peer Association"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "peerEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by peerEducationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "peerEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducationOrganizationPeerAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationOrganizationPeerAssociations/{id}": {
      "get": {
        "operationId": "getEducationOrganizationPeerAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Peer Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationPeerAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_peer_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducationOrganizationPeerAssociation",
        "summary": "Update a education organization peer association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Peer Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducationOrganizationPeerAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationOrganizationPeerAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_peer_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducationOrganizationPeerAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Organization Peer Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_organization_peer_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationServiceCenters": {
      "get": {
        "operationId": "listEducationServiceCenters",
        "summary": "List education service centers",
        "description": "Returns all education service centers for the authenticated tenant.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Service Center"
        ],
        "parameters": [
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducationServiceCenter"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createEducationServiceCenter",
        "summary": "Create an education service center",
        "description": "Creates a new education service center record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Service Center"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducationServiceCenterRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationServiceCenter"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educationServiceCenters/{id}": {
      "get": {
        "operationId": "getEducationServiceCenter",
        "summary": "Get an education service center",
        "description": "Returns a single education service center by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Service Center"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The education service center's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationServiceCenter"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_service_center_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducationServiceCenter",
        "summary": "Update an education service center",
        "description": "Updates mutable fields of an education service center record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Service Center"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The education service center's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducationServiceCenterRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducationServiceCenter"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_service_center_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducationServiceCenter",
        "summary": "Delete an education service center",
        "description": "Soft-deletes an education service center record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Education Service Center"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The education service center's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Education service center soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (education_service_center_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educatorPreparationPrograms": {
      "post": {
        "operationId": "createEducatorPreparationProgram",
        "summary": "Create a educator preparation program",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Educator Preparation Program"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEducatorPreparationProgramRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducatorPreparationProgram"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEducatorPreparationPrograms",
        "summary": "List educator preparation program records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Educator Preparation Program"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by programName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "programTypeDescriptor",
            "in": "query",
            "description": "Filter by programTypeDescriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EducatorPreparationProgram"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/educatorPreparationPrograms/{id}": {
      "get": {
        "operationId": "getEducatorPreparationProgram",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Educator Preparation Program"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducatorPreparationProgram"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (educator_preparation_program_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEducatorPreparationProgram",
        "summary": "Update a educator preparation program",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Educator Preparation Program"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEducatorPreparationProgramRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EducatorPreparationProgram"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (educator_preparation_program_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEducatorPreparationProgram",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Educator Preparation Program"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (educator_preparation_program_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluations": {
      "post": {
        "operationId": "createEvaluation",
        "summary": "Create a evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEvaluationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Evaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEvaluations",
        "summary": "List evaluation records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "performanceEvaluationTitle",
            "in": "query",
            "description": "Filter by performanceEvaluationTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "performanceEvaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationTitle",
            "in": "query",
            "description": "Filter by evaluationTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Evaluation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluations/{id}": {
      "get": {
        "operationId": "getEvaluation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Evaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEvaluation",
        "summary": "Update a evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEvaluationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Evaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEvaluation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationElements": {
      "post": {
        "operationId": "createEvaluationElement",
        "summary": "Create a evaluation element",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEvaluationElementRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationElement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEvaluationElements",
        "summary": "List evaluation element records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationObjectiveTitle",
            "in": "query",
            "description": "Filter by evaluationObjectiveTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationObjectiveTitle",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationElementTitle",
            "in": "query",
            "description": "Filter by evaluationElementTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationElementTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EvaluationElement"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationElements/{id}": {
      "get": {
        "operationId": "getEvaluationElement",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationElement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_element_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEvaluationElement",
        "summary": "Update a evaluation element",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEvaluationElementRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationElement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_element_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEvaluationElement",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_element_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationElementRatings": {
      "post": {
        "operationId": "createEvaluationElementRating",
        "summary": "Create a evaluation element rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element Rating"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEvaluationElementRatingRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationElementRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEvaluationElementRatings",
        "summary": "List evaluation element rating records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element Rating"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationElementTitle",
            "in": "query",
            "description": "Filter by evaluationElementTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationElementTitle",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationDate",
            "in": "query",
            "description": "Filter by evaluationDate.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EvaluationElementRating"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationElementRatings/{id}": {
      "get": {
        "operationId": "getEvaluationElementRating",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationElementRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_element_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEvaluationElementRating",
        "summary": "Update a evaluation element rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEvaluationElementRatingRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationElementRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_element_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEvaluationElementRating",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Element Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_element_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationObjectives": {
      "post": {
        "operationId": "createEvaluationObjective",
        "summary": "Create a evaluation objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEvaluationObjectiveRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEvaluationObjectives",
        "summary": "List evaluation objective records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationTitle",
            "in": "query",
            "description": "Filter by evaluationTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationObjectiveTitle",
            "in": "query",
            "description": "Filter by evaluationObjectiveTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationObjectiveTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EvaluationObjective"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationObjectives/{id}": {
      "get": {
        "operationId": "getEvaluationObjective",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEvaluationObjective",
        "summary": "Update a evaluation objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEvaluationObjectiveRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEvaluationObjective",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationObjectiveRatings": {
      "post": {
        "operationId": "createEvaluationObjectiveRating",
        "summary": "Create a evaluation objective rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective Rating"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEvaluationObjectiveRatingRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationObjectiveRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEvaluationObjectiveRatings",
        "summary": "List evaluation objective rating records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective Rating"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationObjectiveTitle",
            "in": "query",
            "description": "Filter by evaluationObjectiveTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationObjectiveTitle",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationDate",
            "in": "query",
            "description": "Filter by evaluationDate.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EvaluationObjectiveRating"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationObjectiveRatings/{id}": {
      "get": {
        "operationId": "getEvaluationObjectiveRating",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationObjectiveRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_objective_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEvaluationObjectiveRating",
        "summary": "Update a evaluation objective rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEvaluationObjectiveRatingRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationObjectiveRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_objective_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEvaluationObjectiveRating",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Objective Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_objective_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationRatings": {
      "post": {
        "operationId": "createEvaluationRating",
        "summary": "Create a evaluation rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rating"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEvaluationRatingRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEvaluationRatings",
        "summary": "List evaluation rating records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rating"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationTitle",
            "in": "query",
            "description": "Filter by evaluationTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationDate",
            "in": "query",
            "description": "Filter by evaluationDate.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EvaluationRating"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationRatings/{id}": {
      "get": {
        "operationId": "getEvaluationRating",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEvaluationRating",
        "summary": "Update a evaluation rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEvaluationRatingRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEvaluationRating",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationRubricDimensions": {
      "post": {
        "operationId": "createEvaluationRubricDimension",
        "summary": "Create a evaluation rubric dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rubric Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEvaluationRubricDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationRubricDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listEvaluationRubricDimensions",
        "summary": "List evaluation rubric dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rubric Dimension"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by educationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "programEvaluationElementTitle",
            "in": "query",
            "description": "Filter by programEvaluationElementTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEvaluationElementTitle",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationRubricRating",
            "in": "query",
            "description": "Filter by evaluationRubricRating.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationRubricRating",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EvaluationRubricDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/evaluationRubricDimensions/{id}": {
      "get": {
        "operationId": "getEvaluationRubricDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rubric Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationRubricDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_rubric_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateEvaluationRubricDimension",
        "summary": "Update a evaluation rubric dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rubric Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEvaluationRubricDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvaluationRubricDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_rubric_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteEvaluationRubricDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Evaluation Rubric Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (evaluation_rubric_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/exports": {
      "post": {
        "operationId": "createExportJob",
        "summary": "Create an export job",
        "description": "Initiates a bulk export of Ed-Fi entities. Privacy/redaction variants are gated by the `ed_fi:jobs` permission.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Export job"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateExportJobRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExportJob"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listExportJobs",
        "summary": "List export jobs",
        "description": "Lists bulk export job receipts, optionally filtered by status or format.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Export job"
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "Filter by job status.",
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "in_progress",
                "completed",
                "failed"
              ]
            },
            "x-filter": {
              "column": "status",
              "operator": "eq"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Filter by export format.",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "csv",
                "parquet"
              ]
            },
            "x-filter": {
              "column": "format",
              "operator": "eq"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 50, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ExportJob"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/exports/{id}": {
      "get": {
        "operationId": "getExportJob",
        "summary": "Get an export job",
        "description": "Returns one export job receipt by its id.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Export job"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The export job id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExportJob"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (export_job_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/feederSchoolAssociations": {
      "post": {
        "operationId": "createFeederSchoolAssociation",
        "summary": "Create a feeder school association",
        "description": "Creates an association between a feeder school and a receiving school.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Feeder School Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFeederSchoolAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FeederSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listFeederSchoolAssociations",
        "summary": "List feeder school associations",
        "description": "Lists feeder school association records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Feeder School Association"
        ],
        "parameters": [
          {
            "name": "feederSchoolSourcedId",
            "in": "query",
            "description": "Filter by feeder school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "feederSchoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by receiving school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FeederSchoolAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/feederSchoolAssociations/{id}": {
      "get": {
        "operationId": "getFeederSchoolAssociation",
        "summary": "Get a feeder school association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Feeder School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FeederSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (feeder_school_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateFeederSchoolAssociation",
        "summary": "Update a feeder school association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Feeder School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFeederSchoolAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FeederSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (feeder_school_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteFeederSchoolAssociation",
        "summary": "Soft-delete a feeder school association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Feeder School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Feeder school association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (feeder_school_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/fieldworkExperiences": {
      "post": {
        "operationId": "createFieldworkExperience",
        "summary": "Create a fieldwork experience",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFieldworkExperienceRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FieldworkExperience"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listFieldworkExperiences",
        "summary": "List fieldwork experience records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience"
        ],
        "parameters": [
          {
            "name": "fieldworkIdentifier",
            "in": "query",
            "description": "Filter by fieldworkIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "fieldworkIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FieldworkExperience"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/fieldworkExperiences/{id}": {
      "get": {
        "operationId": "getFieldworkExperience",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FieldworkExperience"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fieldwork_experience_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateFieldworkExperience",
        "summary": "Update a fieldwork experience",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFieldworkExperienceRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FieldworkExperience"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fieldwork_experience_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteFieldworkExperience",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fieldwork_experience_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/fieldworkExperienceSectionAssociations": {
      "post": {
        "operationId": "createFieldworkExperienceSectionAssociation",
        "summary": "Create a fieldwork experience section association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience Section Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFieldworkExperienceSectionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FieldworkExperienceSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listFieldworkExperienceSectionAssociations",
        "summary": "List fieldwork experience section association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience Section Association"
        ],
        "parameters": [
          {
            "name": "fieldworkIdentifier",
            "in": "query",
            "description": "Filter by fieldworkIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "fieldworkIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by schoolSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "sectionIdentifier",
            "in": "query",
            "description": "Filter by sectionIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "sectionIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FieldworkExperienceSectionAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/fieldworkExperienceSectionAssociations/{id}": {
      "get": {
        "operationId": "getFieldworkExperienceSectionAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FieldworkExperienceSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fieldwork_experience_section_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateFieldworkExperienceSectionAssociation",
        "summary": "Update a fieldwork experience section association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFieldworkExperienceSectionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FieldworkExperienceSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fieldwork_experience_section_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteFieldworkExperienceSectionAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fieldwork Experience Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fieldwork_experience_section_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/financialAids": {
      "post": {
        "operationId": "createFinancialAid",
        "summary": "Create a financial aid",
        "description": "Creates a financial aid record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Financial Aid"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFinancialAidRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FinancialAid"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listFinancialAids",
        "summary": "List financial aids",
        "description": "Lists financial aids with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Financial Aid"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "beginDate",
            "in": "query",
            "description": "Filter by begin date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "beginDate",
              "operator": "eq"
            }
          },
          {
            "name": "aidTypeDescriptor",
            "in": "query",
            "description": "Filter by aid type.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "aidTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FinancialAid"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/financialAids/{id}": {
      "get": {
        "operationId": "getFinancialAid",
        "summary": "Get a financial aid",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Financial Aid"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FinancialAid"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateFinancialAid",
        "summary": "Update a financial aid",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Financial Aid"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFinancialAidRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FinancialAid"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteFinancialAid",
        "summary": "Delete a financial aid",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Financial Aid"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/functionDimensions": {
      "post": {
        "operationId": "createFunctionDimension",
        "summary": "Create a function dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Function Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFunctionDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FunctionDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listFunctionDimensions",
        "summary": "List function dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Function Dimension"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "description": "Filter by code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "code",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscalYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FunctionDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/functionDimensions/{id}": {
      "get": {
        "operationId": "getFunctionDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Function Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FunctionDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (function_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateFunctionDimension",
        "summary": "Update a function dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Function Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFunctionDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FunctionDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (function_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteFunctionDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Function Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (function_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/fundDimensions": {
      "post": {
        "operationId": "createFundDimension",
        "summary": "Create a fund dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fund Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFundDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FundDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listFundDimensions",
        "summary": "List fund dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fund Dimension"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "description": "Filter by code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "code",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscalYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/FundDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/fundDimensions/{id}": {
      "get": {
        "operationId": "getFundDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fund Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FundDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fund_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateFundDimension",
        "summary": "Update a fund dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fund Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFundDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FundDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fund_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteFundDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Fund Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (fund_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/generalStudentProgramAssociations": {
      "post": {
        "operationId": "createGeneralStudentProgramAssociation",
        "summary": "Create a general student program association",
        "description": "Creates a program participation record associating a student with a program for an effective period. The (studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate) tuple must be unique; overlapping periods for the same subject are rejected.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGeneralStudentProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GeneralStudentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listGeneralStudentProgramAssociations",
        "summary": "List general student program associations",
        "description": "Lists program participation records, optionally filtered by student, program organization, program name, or effective date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "programTypeDescriptor",
            "in": "query",
            "description": "Filter by program type descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GeneralStudentProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/generalStudentProgramAssociations/{id}": {
      "get": {
        "operationId": "getGeneralStudentProgramAssociation",
        "summary": "Get a general student program association",
        "description": "Returns one program participation record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GeneralStudentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateGeneralStudentProgramAssociation",
        "summary": "Update a general student program association",
        "description": "Updates mutable fields of a program participation record (e.g. setting endDate to close the period).\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGeneralStudentProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GeneralStudentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteGeneralStudentProgramAssociation",
        "summary": "Delete a general student program association",
        "description": "Soft-deletes a program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/generalStudentProgramAssociationProgramParticipationStatuses": {
      "post": {
        "operationId": "createGeneralStudentProgramAssociationProgramParticipationStatus",
        "summary": "Create a program participation status",
        "description": "Creates a participation status record for a general student program association.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association Program Participation Status"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGeneralStudentProgramAssociationProgramParticipationStatusRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GeneralStudentProgramAssociationProgramParticipationStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listGeneralStudentProgramAssociationProgramParticipationStatuses",
        "summary": "List program participation statuses",
        "description": "Lists participation status records for general student program associations.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association Program Participation Status"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GeneralStudentProgramAssociationProgramParticipationStatus"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/generalStudentProgramAssociationProgramParticipationStatuses/{id}": {
      "get": {
        "operationId": "getGeneralStudentProgramAssociationProgramParticipationStatus",
        "summary": "Get a program participation status",
        "description": "Returns one participation status record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association Program Participation Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GeneralStudentProgramAssociationProgramParticipationStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateGeneralStudentProgramAssociationProgramParticipationStatus",
        "summary": "Update a program participation status",
        "description": "Updates mutable fields of a participation status record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association Program Participation Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGeneralStudentProgramAssociationProgramParticipationStatusRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GeneralStudentProgramAssociationProgramParticipationStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteGeneralStudentProgramAssociationProgramParticipationStatus",
        "summary": "Delete a program participation status",
        "description": "Soft-deletes a participation status record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "General Student Program Association Program Participation Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/goals": {
      "post": {
        "operationId": "createGoal",
        "summary": "Create a goal",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Goal"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGoalRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Goal"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listGoals",
        "summary": "List goal records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Goal"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "goalTitle",
            "in": "query",
            "description": "Filter by goalTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "goalTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Goal"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/goals/{id}": {
      "get": {
        "operationId": "getGoal",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Goal"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Goal"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (goal_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateGoal",
        "summary": "Update a goal",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Goal"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGoalRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Goal"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (goal_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteGoal",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Goal"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (goal_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/grades": {
      "post": {
        "operationId": "createGrade",
        "summary": "Create a grade",
        "description": "Creates an Ed-Fi grade record for a student in a specific section and grading period.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grade"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradeRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Grade"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listGrades",
        "summary": "List grades",
        "description": "Lists grade records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grade"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "gradingPeriodDescriptor",
            "in": "query",
            "description": "Filter by grading period.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "gradingPeriodDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only grades modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Grade"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/grades/{id}": {
      "get": {
        "operationId": "getGrade",
        "summary": "Get a grade by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grade"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The grade's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Grade"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (grade_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateGrade",
        "summary": "Update a grade",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grade"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The grade's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGradeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Grade"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (grade_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteGrade",
        "summary": "Soft-delete a grade",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grade"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The grade's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Grade soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (grade_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/gradebookEntries": {
      "post": {
        "operationId": "createGradebookEntry",
        "summary": "Create a gradebook entry",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Gradebook Entry"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradebookEntryRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GradebookEntry"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listGradebookEntries",
        "summary": "List gradebook entry records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Gradebook Entry"
        ],
        "parameters": [
          {
            "name": "gradebookEntryIdentifier",
            "in": "query",
            "description": "Filter by gradebookEntryIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "gradebookEntryIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by schoolSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GradebookEntry"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/gradebookEntries/{id}": {
      "get": {
        "operationId": "getGradebookEntry",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Gradebook Entry"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GradebookEntry"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (gradebook_entry_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateGradebookEntry",
        "summary": "Update a gradebook entry",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Gradebook Entry"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGradebookEntryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GradebookEntry"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (gradebook_entry_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteGradebookEntry",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Gradebook Entry"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (gradebook_entry_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/gradingPeriods": {
      "get": {
        "operationId": "listGradingPeriods",
        "summary": "List grading periods",
        "description": "Returns all grading periods for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grading Period"
        ],
        "parameters": [
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only grading periods modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GradingPeriod"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createGradingPeriod",
        "summary": "Create a grading period",
        "description": "Creates a new grading period record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grading Period"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGradingPeriodRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GradingPeriod"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/gradingPeriods/{id}": {
      "get": {
        "operationId": "getGradingPeriod",
        "summary": "Get a grading period",
        "description": "Returns a single grading period by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grading Period"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The grading period's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GradingPeriod"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (grading_period_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateGradingPeriod",
        "summary": "Update a grading period",
        "description": "Updates mutable fields of a grading period record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grading Period"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The grading period's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGradingPeriodRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GradingPeriod"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (grading_period_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteGradingPeriod",
        "summary": "Delete a grading period",
        "description": "Soft-deletes a grading period record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Grading Period"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The grading period's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Grading period soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (grading_period_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/graduationPlans": {
      "post": {
        "operationId": "createGraduationPlan",
        "summary": "Create a graduation plan",
        "description": "Creates an Ed-Fi graduation plan record defining graduation requirements for a cohort.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Graduation Plan"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGraduationPlanRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GraduationPlan"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listGraduationPlans",
        "summary": "List graduation plans",
        "description": "Lists graduation plan records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Graduation Plan"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "graduationPlanTypeDescriptor",
            "in": "query",
            "description": "Filter by graduation plan type.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "graduationPlanTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "graduationSchoolYear",
            "in": "query",
            "description": "Filter by graduation school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "graduationSchoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only graduation plans modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GraduationPlan"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/graduationPlans/{id}": {
      "get": {
        "operationId": "getGraduationPlan",
        "summary": "Get a graduation plan by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Graduation Plan"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The graduation plan's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GraduationPlan"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (graduation_plan_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateGraduationPlan",
        "summary": "Update a graduation plan",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Graduation Plan"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The graduation plan's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGraduationPlanRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GraduationPlan"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (graduation_plan_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteGraduationPlan",
        "summary": "Soft-delete a graduation plan",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Graduation Plan"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The graduation plan's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Graduation plan soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (graduation_plan_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/iDEAEvents": {
      "post": {
        "operationId": "createIdeaEvent",
        "summary": "Create a idea event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "IDEA Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateIdeaEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdeaEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listIdeaEvents",
        "summary": "List idea event records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "IDEA Event"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "ideaEventIdentifier",
            "in": "query",
            "description": "Filter by ideaEventIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "ideaEventIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdeaEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/iDEAEvents/{id}": {
      "get": {
        "operationId": "getIdeaEvent",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "IDEA Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdeaEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (idea_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateIdeaEvent",
        "summary": "Update a idea event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "IDEA Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateIdeaEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdeaEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (idea_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteIdeaEvent",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "IDEA Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (idea_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/imports": {
      "post": {
        "operationId": "createImportJob",
        "summary": "Create an import job",
        "description": "Initiates a bulk complete-model Ed-Fi import. Each row is validated for roster-boundary and descriptor-governance compliance; failures land as `importRow` evidence.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Import job"
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "The idempotency key (max 128 chars). REQUIRED — absent returns 428. A completed replay returns the stored response at 200 with idempotency-replayed: true.",
            "schema": {
              "type": "string",
              "maxLength": 128
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateImportJobRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK (idempotent replay — the stored first response; idempotency-replayed: true).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportJob"
                }
              }
            },
            "headers": {
              "idempotency-replayed": {
                "description": "true when this response is a stored idempotent replay (the hook did not run).",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                }
              },
              "Location": {
                "description": "URI of the created resource (detail route). Persisted on the idempotency row and re-served on replay.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportJob"
                }
              }
            },
            "headers": {
              "idempotency-replayed": {
                "description": "true when this response is a stored idempotent replay (the hook did not run).",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                }
              },
              "Location": {
                "description": "URI of the created resource (detail route). Persisted on the idempotency row and re-served on replay.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict — an operation with this Idempotency-Key is already in progress (60s lock).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity — this Idempotency-Key was already used with a different request body.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this operation requires the Idempotency-Key header.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listImportJobs",
        "summary": "List import jobs",
        "description": "Lists bulk import job receipts, optionally filtered by status.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Import job"
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "Filter by job status.",
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "in_progress",
                "completed",
                "failed"
              ]
            },
            "x-filter": {
              "column": "status",
              "operator": "eq"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 50, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ImportJob"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/imports/{id}": {
      "get": {
        "operationId": "getImportJob",
        "summary": "Get an import job",
        "description": "Returns one import job receipt by its id.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Import job"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The import job id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportJob"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (import_job_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/import-rows": {
      "get": {
        "operationId": "listImportRows",
        "summary": "List import rows",
        "description": "Lists per-row evidence for import jobs, optionally filtered by job or record state.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Import row"
        ],
        "parameters": [
          {
            "name": "importJobId",
            "in": "query",
            "required": true,
            "description": "Filter by the parent import job.",
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "x-filter": {
              "column": "importJobId",
              "operator": "eq"
            }
          },
          {
            "name": "recordState",
            "in": "query",
            "description": "Filter by row outcome state.",
            "schema": {
              "type": "string",
              "enum": [
                "draft",
                "canonical",
                "rejected",
                "soft_deleted"
              ]
            },
            "x-filter": {
              "column": "recordState",
              "operator": "eq"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ImportRow"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/import-rows/{id}": {
      "get": {
        "operationId": "getImportRow",
        "summary": "Get an import row",
        "description": "Returns one import row evidence record by its id.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Import row"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The import row id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportRow"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (import_row_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/interventions": {
      "post": {
        "operationId": "createIntervention",
        "summary": "Create an intervention",
        "description": "Creates an Ed-Fi intervention record defining a program offered by an education organization.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInterventionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Intervention"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listInterventions",
        "summary": "List interventions",
        "description": "Lists intervention records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "interventionClassDescriptor",
            "in": "query",
            "description": "Filter by intervention class.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "interventionClassDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only interventions modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Intervention"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/interventions/{id}": {
      "get": {
        "operationId": "getIntervention",
        "summary": "Get an intervention by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Intervention"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateIntervention",
        "summary": "Update an intervention",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateInterventionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Intervention"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteIntervention",
        "summary": "Soft-delete an intervention",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Intervention soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/interventionPrescriptions": {
      "post": {
        "operationId": "createInterventionPrescription",
        "summary": "Create an intervention prescription",
        "description": "Creates an Ed-Fi intervention prescription record defining a prescribed intervention template.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Prescription"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInterventionPrescriptionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterventionPrescription"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listInterventionPrescriptions",
        "summary": "List intervention prescriptions",
        "description": "Lists intervention prescription records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Prescription"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "interventionClassDescriptor",
            "in": "query",
            "description": "Filter by intervention class.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "interventionClassDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only intervention prescriptions modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/InterventionPrescription"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/interventionPrescriptions/{id}": {
      "get": {
        "operationId": "getInterventionPrescription",
        "summary": "Get an intervention prescription by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Prescription"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention prescription's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterventionPrescription"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_prescription_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateInterventionPrescription",
        "summary": "Update an intervention prescription",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Prescription"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention prescription's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateInterventionPrescriptionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterventionPrescription"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_prescription_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteInterventionPrescription",
        "summary": "Soft-delete an intervention prescription",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Prescription"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention prescription's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Intervention prescription soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_prescription_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/interventionStudies": {
      "post": {
        "operationId": "createInterventionStudy",
        "summary": "Create an intervention study",
        "description": "Creates an Ed-Fi intervention study record documenting research on intervention effectiveness.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Study"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInterventionStudyRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterventionStudy"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listInterventionStudies",
        "summary": "List intervention studies",
        "description": "Lists intervention study records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Study"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "interventionClassDescriptor",
            "in": "query",
            "description": "Filter by intervention class.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "interventionClassDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only intervention studies modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/InterventionStudy"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/interventionStudies/{id}": {
      "get": {
        "operationId": "getInterventionStudy",
        "summary": "Get an intervention study by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Study"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention study's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterventionStudy"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_study_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateInterventionStudy",
        "summary": "Update an intervention study",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Study"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention study's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateInterventionStudyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterventionStudy"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_study_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteInterventionStudy",
        "summary": "Soft-delete an intervention study",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Intervention Study"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The intervention study's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Intervention study soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (intervention_study_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/learningStandards": {
      "post": {
        "operationId": "createLearningStandard",
        "summary": "Create a learning standard",
        "description": "Creates an Ed-Fi learning standard by writing the case:cfItem primary row plus the learningStandardExtension companion in one transaction. Supply the CASE `identifier` (uuid) and the Ed-Fi `learningStandardId`.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLearningStandardRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LearningStandard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLearningStandards",
        "summary": "List learning standards",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard"
        ],
        "parameters": [
          {
            "name": "learningStandardId",
            "in": "query",
            "description": "Filter by learning standard identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "learningStandardId",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LearningStandard"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/learningStandards/{id}": {
      "get": {
        "operationId": "getLearningStandard",
        "summary": "Get by CASE identifier",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LearningStandard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (learning_standard_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLearningStandard",
        "summary": "Update",
        "description": "Updates Ed-Fi-owned companion fields. Shared fields (description, uri, learningStandardItemCode) require edfi:write-shared.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLearningStandardRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LearningStandard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (learning_standard_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLearningStandard",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (learning_standard_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/learningStandardEquivalenceAssociations": {
      "post": {
        "operationId": "createLearningStandardEquivalenceAssociation",
        "summary": "Create a learning standard equivalence association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard Equivalence Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLearningStandardEquivalenceAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LearningStandardEquivalenceAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLearningStandardEquivalenceAssociations",
        "summary": "List learning standard equivalence associations",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard Equivalence Association"
        ],
        "parameters": [
          {
            "name": "sourceLearningStandardId",
            "in": "query",
            "description": "Filter by source learning standard.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "sourceLearningStandardId",
              "operator": "eq"
            }
          },
          {
            "name": "targetLearningStandardId",
            "in": "query",
            "description": "Filter by target learning standard.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "targetLearningStandardId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LearningStandardEquivalenceAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/learningStandardEquivalenceAssociations/{id}": {
      "get": {
        "operationId": "getLearningStandardEquivalenceAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard Equivalence Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LearningStandardEquivalenceAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (learning_standard_equivalence_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLearningStandardEquivalenceAssociation",
        "summary": "Update",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard Equivalence Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLearningStandardEquivalenceAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LearningStandardEquivalenceAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (learning_standard_equivalence_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLearningStandardEquivalenceAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Learning Standard Equivalence Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (learning_standard_equivalence_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localAccounts": {
      "post": {
        "operationId": "createLocalAccount",
        "summary": "Create an account code",
        "description": "Creates an Ed-Fi account code record as a child of an account.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Account"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocalAccountRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLocalAccounts",
        "summary": "List account codes",
        "description": "Lists account code records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Account"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "accountIdentifier",
            "in": "query",
            "description": "Filter by account identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "accountIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscal year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocalAccount"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localAccounts/{id}": {
      "get": {
        "operationId": "getLocalAccount",
        "summary": "Get an account code by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Account"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_account_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLocalAccount",
        "summary": "Update an account code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Account"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLocalAccountRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalAccount"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_account_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLocalAccount",
        "summary": "Soft-delete an account code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Account"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Account code soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_account_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localActuals": {
      "post": {
        "operationId": "createLocalActual",
        "summary": "Create an actual",
        "description": "Creates an Ed-Fi actual expenditure or revenue record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Actual"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocalActualRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalActual"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLocalActuals",
        "summary": "List actuals",
        "description": "Lists actual records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Actual"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscal year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "asOfDate",
            "in": "query",
            "description": "Filter by as-of date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "asOfDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocalActual"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localActuals/{id}": {
      "get": {
        "operationId": "getLocalActual",
        "summary": "Get an actual by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Actual"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalActual"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_actual_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLocalActual",
        "summary": "Update an actual",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Actual"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLocalActualRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalActual"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_actual_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLocalActual",
        "summary": "Soft-delete an actual",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Actual"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "LocalActual soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_actual_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localBudgets": {
      "post": {
        "operationId": "createLocalBudget",
        "summary": "Create a budget",
        "description": "Creates an Ed-Fi budget record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Budget"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocalBudgetRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalBudget"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLocalBudgets",
        "summary": "List budgets",
        "description": "Lists budget records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Budget"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscal year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "asOfDate",
            "in": "query",
            "description": "Filter by as-of date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "asOfDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocalBudget"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localBudgets/{id}": {
      "get": {
        "operationId": "getLocalBudget",
        "summary": "Get a budget by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Budget"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalBudget"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_budget_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLocalBudget",
        "summary": "Update a budget",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Budget"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLocalBudgetRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalBudget"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_budget_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLocalBudget",
        "summary": "Soft-delete a budget",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Budget"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "LocalBudget soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_budget_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localContractedStaffs": {
      "post": {
        "operationId": "createLocalContractedStaff",
        "summary": "Create a contracted staff record",
        "description": "Creates an Ed-Fi contracted staff expenditure record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Contracted Staff"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocalContractedStaffRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalContractedStaff"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLocalContractedStaffs",
        "summary": "List contracted staff records",
        "description": "Lists contracted staff records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Contracted Staff"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscal year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocalContractedStaff"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localContractedStaffs/{id}": {
      "get": {
        "operationId": "getLocalContractedStaff",
        "summary": "Get a contracted staff record by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Contracted Staff"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalContractedStaff"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_contracted_staff_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLocalContractedStaff",
        "summary": "Update a contracted staff record",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Contracted Staff"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLocalContractedStaffRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalContractedStaff"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_contracted_staff_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLocalContractedStaff",
        "summary": "Soft-delete a contracted staff record",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Contracted Staff"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Contracted staff record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_contracted_staff_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localEducationAgencies": {
      "get": {
        "operationId": "listLocalEducationAgencies",
        "summary": "List local education agencies",
        "description": "Returns all local education agencies for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Education Agency"
        ],
        "parameters": [
          {
            "name": "localEducationAgencyCategoryDescriptor",
            "in": "query",
            "description": "Filter by LEA category descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "localEducationAgencyCategoryDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only LEAs modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocalEducationAgency"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createLocalEducationAgency",
        "summary": "Create a local education agency",
        "description": "Creates a new local education agency record by writing through into the oneroster:org master.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Education Agency"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocalEducationAgencyRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalEducationAgency"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localEducationAgencies/{id}": {
      "get": {
        "operationId": "getLocalEducationAgency",
        "summary": "Get a local education agency",
        "description": "Returns a single local education agency by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Education Agency"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The LEA's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalEducationAgency"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_education_agency_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLocalEducationAgency",
        "summary": "Update a local education agency",
        "description": "Updates a local education agency record. Shared roster fields (localEducationAgencyId, nameOfInstitution) require edfi:write-shared.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Education Agency"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The LEA's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLocalEducationAgencyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalEducationAgency"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_education_agency_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLocalEducationAgency",
        "summary": "Delete a local education agency",
        "description": "Soft-deletes a local education agency record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Education Agency"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The LEA's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Local education agency soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_education_agency_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localEncumbrances": {
      "post": {
        "operationId": "createLocalEncumbrance",
        "summary": "Create a local encumbrance",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Encumbrance"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocalEncumbranceRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalEncumbrance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLocalEncumbrances",
        "summary": "List local encumbrance records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Encumbrance"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by educationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscalYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "asOfDate",
            "in": "query",
            "description": "Filter by asOfDate.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "asOfDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocalEncumbrance"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localEncumbrances/{id}": {
      "get": {
        "operationId": "getLocalEncumbrance",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Encumbrance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalEncumbrance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_encumbrance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLocalEncumbrance",
        "summary": "Update a local encumbrance",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Encumbrance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLocalEncumbranceRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalEncumbrance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_encumbrance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLocalEncumbrance",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Encumbrance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_encumbrance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localPayrolls": {
      "post": {
        "operationId": "createLocalPayroll",
        "summary": "Create a payroll record",
        "description": "Creates an Ed-Fi payroll record for a staff member.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Payroll"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocalPayrollRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalPayroll"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLocalPayrolls",
        "summary": "List payroll records",
        "description": "Lists payroll records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Payroll"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscal year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LocalPayroll"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/localPayrolls/{id}": {
      "get": {
        "operationId": "getLocalPayroll",
        "summary": "Get a payroll record by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Payroll"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalPayroll"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_payroll_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLocalPayroll",
        "summary": "Update a payroll record",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Payroll"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLocalPayrollRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LocalPayroll"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_payroll_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLocalPayroll",
        "summary": "Soft-delete a payroll record",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Local Payroll"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "LocalPayroll record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (local_payroll_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/locations": {
      "post": {
        "operationId": "createLocation",
        "summary": "Create a location",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Location"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Location"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listLocations",
        "summary": "List location records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Location"
        ],
        "parameters": [
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by schoolSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "classroomIdentificationCode",
            "in": "query",
            "description": "Filter by classroomIdentificationCode.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "classroomIdentificationCode",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Location"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/locations/{id}": {
      "get": {
        "operationId": "getLocation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Location"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Location"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (location_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateLocation",
        "summary": "Update a location",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Location"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLocationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Location"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (location_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteLocation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Location"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (location_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/objectDimensions": {
      "post": {
        "operationId": "createObjectDimension",
        "summary": "Create a object dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Object Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateObjectDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObjectDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listObjectDimensions",
        "summary": "List object dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Object Dimension"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "description": "Filter by code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "code",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscalYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ObjectDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/objectDimensions/{id}": {
      "get": {
        "operationId": "getObjectDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Object Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObjectDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (object_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateObjectDimension",
        "summary": "Update a object dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Object Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateObjectDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObjectDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (object_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteObjectDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Object Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (object_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/objectiveAssessments": {
      "post": {
        "operationId": "createObjectiveAssessment",
        "summary": "Create an objective assessment",
        "description": "Creates a sub-component of an assessment that tests a specific learning objective or standard.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Objective Assessment"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateObjectiveAssessmentRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObjectiveAssessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listObjectiveAssessments",
        "summary": "List objective assessments",
        "description": "Lists objective assessment records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Objective Assessment"
        ],
        "parameters": [
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessment identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ObjectiveAssessment"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/objectiveAssessments/{id}": {
      "get": {
        "operationId": "getObjectiveAssessment",
        "summary": "Get an objective assessment by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Objective Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The objective assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObjectiveAssessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (objective_assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateObjectiveAssessment",
        "summary": "Update an objective assessment",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Objective Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The objective assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateObjectiveAssessmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObjectiveAssessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (objective_assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteObjectiveAssessment",
        "summary": "Soft-delete an objective assessment",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Objective Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The objective assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Objective assessment soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (objective_assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/openStaffPositions": {
      "post": {
        "operationId": "createOpenStaffPosition",
        "summary": "Create an open staff position",
        "description": "Creates a staff position vacancy record for an education organization.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateOpenStaffPositionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenStaffPosition"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listOpenStaffPositions",
        "summary": "List open staff positions",
        "description": "Lists open staff position records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "staffClassificationDescriptor",
            "in": "query",
            "description": "Filter by staff classification.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffClassificationDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OpenStaffPosition"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/openStaffPositions/{id}": {
      "get": {
        "operationId": "getOpenStaffPosition",
        "summary": "Get an open staff position by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The open staff position's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenStaffPosition"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (open_staff_position_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateOpenStaffPosition",
        "summary": "Update an open staff position",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The open staff position's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateOpenStaffPositionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenStaffPosition"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (open_staff_position_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteOpenStaffPosition",
        "summary": "Soft-delete an open staff position",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The open staff position's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Open staff position soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (open_staff_position_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/openStaffPositionEvents": {
      "post": {
        "operationId": "createOpenStaffPositionEvent",
        "summary": "Create a open staff position event",
        "description": "Creates a open staff position event record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateOpenStaffPositionEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenStaffPositionEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listOpenStaffPositionEvents",
        "summary": "List open staff position events",
        "description": "Lists open staff position events with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position Event"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "requisitionNumber",
            "in": "query",
            "description": "Filter by requisition number.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "requisitionNumber",
              "operator": "eq"
            }
          },
          {
            "name": "eventDate",
            "in": "query",
            "description": "Filter by event date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "eventDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OpenStaffPositionEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/openStaffPositionEvents/{id}": {
      "get": {
        "operationId": "getOpenStaffPositionEvent",
        "summary": "Get a open staff position event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenStaffPositionEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateOpenStaffPositionEvent",
        "summary": "Update a open staff position event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateOpenStaffPositionEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenStaffPositionEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteOpenStaffPositionEvent",
        "summary": "Delete a open staff position event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Open Staff Position Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/operationalUnitDimensions": {
      "post": {
        "operationId": "createOperationalUnitDimension",
        "summary": "Create a operational unit dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Operational Unit Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateOperationalUnitDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationalUnitDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listOperationalUnitDimensions",
        "summary": "List operational unit dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Operational Unit Dimension"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "description": "Filter by code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "code",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscalYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OperationalUnitDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/operationalUnitDimensions/{id}": {
      "get": {
        "operationId": "getOperationalUnitDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Operational Unit Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationalUnitDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (operational_unit_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateOperationalUnitDimension",
        "summary": "Update a operational unit dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Operational Unit Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateOperationalUnitDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OperationalUnitDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (operational_unit_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteOperationalUnitDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Operational Unit Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (operational_unit_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/organizationDepartments": {
      "post": {
        "operationId": "createOrganizationDepartment",
        "summary": "Create a organization department",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Organization Department"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateOrganizationDepartmentRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationDepartment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listOrganizationDepartments",
        "summary": "List organization department records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Organization Department"
        ],
        "parameters": [
          {
            "name": "organizationDepartmentId",
            "in": "query",
            "description": "Filter by organizationDepartmentId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "organizationDepartmentId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OrganizationDepartment"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/organizationDepartments/{id}": {
      "get": {
        "operationId": "getOrganizationDepartment",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Organization Department"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationDepartment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (organization_department_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateOrganizationDepartment",
        "summary": "Update a organization department",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Organization Department"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateOrganizationDepartmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationDepartment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (organization_department_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteOrganizationDepartment",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Organization Department"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (organization_department_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/paths": {
      "post": {
        "operationId": "createPath",
        "summary": "Create a path",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePathRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Path"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listPaths",
        "summary": "List path records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "pathName",
            "in": "query",
            "description": "Filter by pathName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "pathName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Path"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/paths/{id}": {
      "get": {
        "operationId": "getPath",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Path"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updatePath",
        "summary": "Update a path",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePathRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Path"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deletePath",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/pathMilestones": {
      "post": {
        "operationId": "createPathMilestone",
        "summary": "Create a path milestone",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Milestone"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePathMilestoneRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PathMilestone"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listPathMilestones",
        "summary": "List path milestone records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Milestone"
        ],
        "parameters": [
          {
            "name": "pathMilestoneName",
            "in": "query",
            "description": "Filter by pathMilestoneName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "pathMilestoneName",
              "operator": "eq"
            }
          },
          {
            "name": "pathMilestoneTypeDescriptor",
            "in": "query",
            "description": "Filter by pathMilestoneTypeDescriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "pathMilestoneTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PathMilestone"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/pathMilestones/{id}": {
      "get": {
        "operationId": "getPathMilestone",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Milestone"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PathMilestone"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_milestone_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updatePathMilestone",
        "summary": "Update a path milestone",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Milestone"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePathMilestoneRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PathMilestone"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_milestone_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deletePathMilestone",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Milestone"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_milestone_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/pathPhases": {
      "post": {
        "operationId": "createPathPhase",
        "summary": "Create a path phase",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Phase"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePathPhaseRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PathPhase"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listPathPhases",
        "summary": "List path phase records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Phase"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "pathName",
            "in": "query",
            "description": "Filter by pathName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "pathName",
              "operator": "eq"
            }
          },
          {
            "name": "pathPhaseName",
            "in": "query",
            "description": "Filter by pathPhaseName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "pathPhaseName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PathPhase"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/pathPhases/{id}": {
      "get": {
        "operationId": "getPathPhase",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Phase"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PathPhase"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_phase_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updatePathPhase",
        "summary": "Update a path phase",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Phase"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePathPhaseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PathPhase"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_phase_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deletePathPhase",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Path Phase"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (path_phase_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/performanceEvaluations": {
      "post": {
        "operationId": "createPerformanceEvaluation",
        "summary": "Create a performance evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePerformanceEvaluationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerformanceEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listPerformanceEvaluations",
        "summary": "List performance evaluation records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "performanceEvaluationTitle",
            "in": "query",
            "description": "Filter by performanceEvaluationTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "performanceEvaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by schoolYear.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PerformanceEvaluation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/performanceEvaluations/{id}": {
      "get": {
        "operationId": "getPerformanceEvaluation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerformanceEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (performance_evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updatePerformanceEvaluation",
        "summary": "Update a performance evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePerformanceEvaluationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerformanceEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (performance_evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deletePerformanceEvaluation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (performance_evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/performanceEvaluationRatings": {
      "post": {
        "operationId": "createPerformanceEvaluationRating",
        "summary": "Create a performance evaluation rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation Rating"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePerformanceEvaluationRatingRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerformanceEvaluationRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listPerformanceEvaluationRatings",
        "summary": "List performance evaluation rating records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation Rating"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "performanceEvaluationTitle",
            "in": "query",
            "description": "Filter by performanceEvaluationTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "performanceEvaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PerformanceEvaluationRating"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/performanceEvaluationRatings/{id}": {
      "get": {
        "operationId": "getPerformanceEvaluationRating",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerformanceEvaluationRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (performance_evaluation_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updatePerformanceEvaluationRating",
        "summary": "Update a performance evaluation rating",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePerformanceEvaluationRatingRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PerformanceEvaluationRating"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (performance_evaluation_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deletePerformanceEvaluationRating",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Performance Evaluation Rating"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (performance_evaluation_rating_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/persons": {
      "post": {
        "operationId": "createPerson",
        "summary": "Create a person",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Person"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePersonRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Person"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listPersons",
        "summary": "List person records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Person"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "sourceSystemDescriptor",
            "in": "query",
            "description": "Filter by sourceSystemDescriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "sourceSystemDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Person"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/persons/{id}": {
      "get": {
        "operationId": "getPerson",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Person"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Person"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (person_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updatePerson",
        "summary": "Update a person",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Person"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePersonRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Person"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (person_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deletePerson",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Person"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (person_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/postSecondaryEvents": {
      "post": {
        "operationId": "createPostSecondaryEvent",
        "summary": "Create a post-secondary event",
        "description": "Creates a post-secondary event record for a student.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePostSecondaryEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostSecondaryEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listPostSecondaryEvents",
        "summary": "List post-secondary events",
        "description": "Lists post-secondary event records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Event"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "postSecondaryEventCategoryDescriptor",
            "in": "query",
            "description": "Filter by event category.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "postSecondaryEventCategoryDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PostSecondaryEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/postSecondaryEvents/{id}": {
      "get": {
        "operationId": "getPostSecondaryEvent",
        "summary": "Get a post-secondary event by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The post-secondary event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostSecondaryEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (post_secondary_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updatePostSecondaryEvent",
        "summary": "Update a post-secondary event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The post-secondary event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePostSecondaryEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostSecondaryEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (post_secondary_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deletePostSecondaryEvent",
        "summary": "Soft-delete a post-secondary event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The post-secondary event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Post-secondary event soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (post_secondary_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/postSecondaryInstitutions": {
      "get": {
        "operationId": "listPostSecondaryInstitutions",
        "summary": "List post-secondary institutions",
        "description": "Returns all post-secondary institutions for the authenticated tenant.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Institution"
        ],
        "parameters": [
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PostSecondaryInstitution"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createPostSecondaryInstitution",
        "summary": "Create a post-secondary institution",
        "description": "Creates a new post-secondary institution record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Institution"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePostSecondaryInstitutionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostSecondaryInstitution"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/postSecondaryInstitutions/{id}": {
      "get": {
        "operationId": "getPostSecondaryInstitution",
        "summary": "Get a post-secondary institution",
        "description": "Returns a single post-secondary institution by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Institution"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The institution's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostSecondaryInstitution"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (post_secondary_institution_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updatePostSecondaryInstitution",
        "summary": "Update a post-secondary institution",
        "description": "Updates mutable fields of a post-secondary institution record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Institution"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The institution's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePostSecondaryInstitutionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostSecondaryInstitution"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (post_secondary_institution_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deletePostSecondaryInstitution",
        "summary": "Delete a post-secondary institution",
        "description": "Soft-deletes a post-secondary institution record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Post-Secondary Institution"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The institution's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Post-secondary institution soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (post_secondary_institution_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/professionalDevelopmentEvents": {
      "post": {
        "operationId": "createProfessionalDevelopmentEvent",
        "summary": "Create a professional development event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProfessionalDevelopmentEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfessionalDevelopmentEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listProfessionalDevelopmentEvents",
        "summary": "List professional development event records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "professionalDevelopmentTitle",
            "in": "query",
            "description": "Filter by professionalDevelopmentTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "professionalDevelopmentTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProfessionalDevelopmentEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/professionalDevelopmentEvents/{id}": {
      "get": {
        "operationId": "getProfessionalDevelopmentEvent",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfessionalDevelopmentEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (professional_development_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateProfessionalDevelopmentEvent",
        "summary": "Update a professional development event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProfessionalDevelopmentEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfessionalDevelopmentEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (professional_development_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteProfessionalDevelopmentEvent",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (professional_development_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/professionalDevelopmentEventAttendances": {
      "post": {
        "operationId": "createProfessionalDevelopmentEventAttendance",
        "summary": "Create a professional development event attendance",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event Attendance"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProfessionalDevelopmentEventAttendanceRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfessionalDevelopmentEventAttendance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listProfessionalDevelopmentEventAttendances",
        "summary": "List professional development event attendance records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event Attendance"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "sourceSystemDescriptor",
            "in": "query",
            "description": "Filter by sourceSystemDescriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "sourceSystemDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProfessionalDevelopmentEventAttendance"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/professionalDevelopmentEventAttendances/{id}": {
      "get": {
        "operationId": "getProfessionalDevelopmentEventAttendance",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event Attendance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfessionalDevelopmentEventAttendance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (professional_development_event_attendance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateProfessionalDevelopmentEventAttendance",
        "summary": "Update a professional development event attendance",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event Attendance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProfessionalDevelopmentEventAttendanceRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfessionalDevelopmentEventAttendance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (professional_development_event_attendance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteProfessionalDevelopmentEventAttendance",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Professional Development Event Attendance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (professional_development_event_attendance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programs": {
      "post": {
        "operationId": "createProgram",
        "summary": "Create a program",
        "description": "Creates an Ed-Fi program record. The educationOrganizationId must reference an existing OneRoster organization.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProgramRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Program"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listPrograms",
        "summary": "List programs",
        "description": "Lists program records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "programTypeDescriptor",
            "in": "query",
            "description": "Filter by program type.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only programs modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Program"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programs/{id}": {
      "get": {
        "operationId": "getProgram",
        "summary": "Get a program by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The program's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Program"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateProgram",
        "summary": "Update a program",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The program's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProgramRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Program"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteProgram",
        "summary": "Soft-delete a program",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The program's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Program soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programDimensions": {
      "post": {
        "operationId": "createProgramDimension",
        "summary": "Create a program dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProgramDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listProgramDimensions",
        "summary": "List program dimensions",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Dimension"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "programTypeDescriptor",
            "in": "query",
            "description": "Filter by program type.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProgramDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programDimensions/{id}": {
      "get": {
        "operationId": "getProgramDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateProgramDimension",
        "summary": "Update a program dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProgramDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteProgramDimension",
        "summary": "Soft-delete a program dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programEvaluations": {
      "post": {
        "operationId": "createProgramEvaluation",
        "summary": "Create a program evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProgramEvaluationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listProgramEvaluations",
        "summary": "List program evaluations",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "programTypeDescriptor",
            "in": "query",
            "description": "Filter by program type.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "programEvaluationTitle",
            "in": "query",
            "description": "Filter by evaluation title.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEvaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProgramEvaluation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programEvaluations/{id}": {
      "get": {
        "operationId": "getProgramEvaluation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateProgramEvaluation",
        "summary": "Update a program evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProgramEvaluationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteProgramEvaluation",
        "summary": "Soft-delete a program evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programEvaluationElements": {
      "post": {
        "operationId": "createProgramEvaluationElement",
        "summary": "Create a program evaluation element",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Element"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProgramEvaluationElementRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluationElement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listProgramEvaluationElements",
        "summary": "List program evaluation elements",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Element"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "programEvaluationTitle",
            "in": "query",
            "description": "Filter by evaluation title.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEvaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProgramEvaluationElement"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programEvaluationElements/{id}": {
      "get": {
        "operationId": "getProgramEvaluationElement",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Element"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluationElement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_element_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateProgramEvaluationElement",
        "summary": "Update a program evaluation element",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Element"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProgramEvaluationElementRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluationElement"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_element_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteProgramEvaluationElement",
        "summary": "Soft-delete a program evaluation element",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Element"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_element_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programEvaluationObjectives": {
      "post": {
        "operationId": "createProgramEvaluationObjective",
        "summary": "Create a program evaluation objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Objective"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProgramEvaluationObjectiveRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluationObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listProgramEvaluationObjectives",
        "summary": "List program evaluation objectives",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Objective"
        ],
        "parameters": [
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "programEvaluationTitle",
            "in": "query",
            "description": "Filter by evaluation title.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEvaluationTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProgramEvaluationObjective"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/programEvaluationObjectives/{id}": {
      "get": {
        "operationId": "getProgramEvaluationObjective",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluationObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateProgramEvaluationObjective",
        "summary": "Update a program evaluation objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProgramEvaluationObjectiveRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramEvaluationObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteProgramEvaluationObjective",
        "summary": "Soft-delete a program evaluation objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Program Evaluation Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (program_evaluation_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/projectDimensions": {
      "post": {
        "operationId": "createProjectDimension",
        "summary": "Create a project dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Project Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProjectDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listProjectDimensions",
        "summary": "List project dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Project Dimension"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "description": "Filter by code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "code",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscalYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProjectDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/projectDimensions/{id}": {
      "get": {
        "operationId": "getProjectDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Project Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (project_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateProjectDimension",
        "summary": "Update a project dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Project Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProjectDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (project_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteProjectDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Project Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (project_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/quantitativeMeasures": {
      "post": {
        "operationId": "createQuantitativeMeasure",
        "summary": "Create a quantitative measure",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateQuantitativeMeasureRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuantitativeMeasure"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listQuantitativeMeasures",
        "summary": "List quantitative measure records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationElementTitle",
            "in": "query",
            "description": "Filter by evaluationElementTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationElementTitle",
              "operator": "eq"
            }
          },
          {
            "name": "quantitativeMeasureIdentifier",
            "in": "query",
            "description": "Filter by quantitativeMeasureIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "quantitativeMeasureIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/QuantitativeMeasure"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/quantitativeMeasures/{id}": {
      "get": {
        "operationId": "getQuantitativeMeasure",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuantitativeMeasure"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (quantitative_measure_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateQuantitativeMeasure",
        "summary": "Update a quantitative measure",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateQuantitativeMeasureRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuantitativeMeasure"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (quantitative_measure_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteQuantitativeMeasure",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (quantitative_measure_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/quantitativeMeasureScores": {
      "post": {
        "operationId": "createQuantitativeMeasureScore",
        "summary": "Create a quantitative measure score",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure Score"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateQuantitativeMeasureScoreRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuantitativeMeasureScore"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listQuantitativeMeasureScores",
        "summary": "List quantitative measure score records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure Score"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "quantitativeMeasureIdentifier",
            "in": "query",
            "description": "Filter by quantitativeMeasureIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "quantitativeMeasureIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationDate",
            "in": "query",
            "description": "Filter by evaluationDate.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/QuantitativeMeasureScore"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/quantitativeMeasureScores/{id}": {
      "get": {
        "operationId": "getQuantitativeMeasureScore",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure Score"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuantitativeMeasureScore"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (quantitative_measure_score_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateQuantitativeMeasureScore",
        "summary": "Update a quantitative measure score",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure Score"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateQuantitativeMeasureScoreRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuantitativeMeasureScore"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (quantitative_measure_score_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteQuantitativeMeasureScore",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Quantitative Measure Score"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (quantitative_measure_score_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/recruitmentEvents": {
      "post": {
        "operationId": "createRecruitmentEvent",
        "summary": "Create a recruitment event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRecruitmentEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecruitmentEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listRecruitmentEvents",
        "summary": "List recruitment event records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "eventTitle",
            "in": "query",
            "description": "Filter by eventTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "eventTitle",
              "operator": "eq"
            }
          },
          {
            "name": "eventDate",
            "in": "query",
            "description": "Filter by eventDate.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "eventDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RecruitmentEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/recruitmentEvents/{id}": {
      "get": {
        "operationId": "getRecruitmentEvent",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecruitmentEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (recruitment_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateRecruitmentEvent",
        "summary": "Update a recruitment event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRecruitmentEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecruitmentEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (recruitment_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteRecruitmentEvent",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (recruitment_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/recruitmentEventAttendances": {
      "post": {
        "operationId": "createRecruitmentEventAttendance",
        "summary": "Create a recruitment event attendance",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event Attendance"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRecruitmentEventAttendanceRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecruitmentEventAttendance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listRecruitmentEventAttendances",
        "summary": "List recruitment event attendance records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event Attendance"
        ],
        "parameters": [
          {
            "name": "recruitmentEventAttendeeIdentifier",
            "in": "query",
            "description": "Filter by recruitmentEventAttendeeIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "recruitmentEventAttendeeIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "eventTitle",
            "in": "query",
            "description": "Filter by eventTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "eventTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RecruitmentEventAttendance"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/recruitmentEventAttendances/{id}": {
      "get": {
        "operationId": "getRecruitmentEventAttendance",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event Attendance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecruitmentEventAttendance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (recruitment_event_attendance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateRecruitmentEventAttendance",
        "summary": "Update a recruitment event attendance",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event Attendance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRecruitmentEventAttendanceRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecruitmentEventAttendance"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (recruitment_event_attendance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteRecruitmentEventAttendance",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Recruitment Event Attendance"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (recruitment_event_attendance_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/reportCards": {
      "post": {
        "operationId": "createReportCard",
        "summary": "Create a report card",
        "description": "Creates an Ed-Fi report card record for a student in a specific grading period.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Report Card"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateReportCardRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportCard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listReportCards",
        "summary": "List report cards",
        "description": "Lists report card records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Report Card"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only report cards modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ReportCard"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/reportCards/{id}": {
      "get": {
        "operationId": "getReportCard",
        "summary": "Get a report card by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Report Card"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The report card's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportCard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (report_card_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateReportCard",
        "summary": "Update a report card",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Report Card"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The report card's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateReportCardRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReportCard"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (report_card_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteReportCard",
        "summary": "Soft-delete a report card",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Report Card"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The report card's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Report card soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (report_card_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/restraintEvents": {
      "post": {
        "operationId": "createRestraintEvent",
        "summary": "Create a restraint event",
        "description": "Creates a restraint event record for a student at a school.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Restraint Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRestraintEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RestraintEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listRestraintEvents",
        "summary": "List restraint events",
        "description": "Lists restraint event records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Restraint Event"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RestraintEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/restraintEvents/{id}": {
      "get": {
        "operationId": "getRestraintEvent",
        "summary": "Get a restraint event by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Restraint Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The restraint event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RestraintEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (restraint_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateRestraintEvent",
        "summary": "Update a restraint event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Restraint Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The restraint event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRestraintEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RestraintEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (restraint_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteRestraintEvent",
        "summary": "Soft-delete a restraint event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Restraint Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The restraint event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Restraint event soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (restraint_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/rubricDimensions": {
      "post": {
        "operationId": "createRubricDimension",
        "summary": "Create a rubric dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Rubric Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRubricDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RubricDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listRubricDimensions",
        "summary": "List rubric dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Rubric Dimension"
        ],
        "parameters": [
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationElementTitle",
            "in": "query",
            "description": "Filter by evaluationElementTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "evaluationElementTitle",
              "operator": "eq"
            }
          },
          {
            "name": "rubricRating",
            "in": "query",
            "description": "Filter by rubricRating.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "rubricRating",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RubricDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/rubricDimensions/{id}": {
      "get": {
        "operationId": "getRubricDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Rubric Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RubricDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (rubric_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateRubricDimension",
        "summary": "Update a rubric dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Rubric Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRubricDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RubricDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (rubric_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteRubricDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Rubric Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (rubric_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/schools": {
      "get": {
        "operationId": "listSchools",
        "summary": "List schools",
        "description": "Returns all schools for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "School"
        ],
        "parameters": [
          {
            "name": "operationalStatusDescriptor",
            "in": "query",
            "description": "Filter by operational status descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "operationalStatusDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "schoolTypeDescriptor",
            "in": "query",
            "description": "Filter by school type descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolTypeDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only schools modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/School"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createSchool",
        "summary": "Create a school",
        "description": "Creates a new school education organization record by writing through into the oneroster:org master.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "School"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSchoolRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/School"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/schools/{id}": {
      "get": {
        "operationId": "getSchool",
        "summary": "Get a school",
        "description": "Returns a single school by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "School"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The school's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/School"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (school_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSchool",
        "summary": "Update a school",
        "description": "Updates a school record. Shared roster fields (schoolSourcedId, nameOfInstitution) require edfi:write-shared.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "School"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The school's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSchoolRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/School"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (school_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSchool",
        "summary": "Delete a school",
        "description": "Soft-deletes a school education organization record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "School"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The school's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "School soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (school_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/sections": {
      "post": {
        "operationId": "createSection",
        "summary": "Create a section",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSectionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Section"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSections",
        "summary": "List sections",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section"
        ],
        "parameters": [
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "localCourseCode",
            "in": "query",
            "description": "Filter by local course code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "localCourseCode",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "termDescriptor",
            "in": "query",
            "description": "Filter by term.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "termDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "sectionIdentifier",
            "in": "query",
            "description": "Filter by section identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "sectionIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Section"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/sections/{id}": {
      "get": {
        "operationId": "getSection",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Section"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (section_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSection",
        "summary": "Update",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSectionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Section"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (section_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSection",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (section_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/sectionAttendanceTakenEvents": {
      "post": {
        "operationId": "createSectionAttendanceTakenEvent",
        "summary": "Create a section attendance taken event",
        "description": "Creates a record indicating that attendance was taken for a specific section on a date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section Attendance Taken Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSectionAttendanceTakenEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SectionAttendanceTakenEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSectionAttendanceTakenEvents",
        "summary": "List section attendance taken events",
        "description": "Lists section attendance taken event records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section Attendance Taken Event"
        ],
        "parameters": [
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "classSourcedId",
            "in": "query",
            "description": "Filter by class sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "classSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "eventDate",
            "in": "query",
            "description": "Filter by event date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "eventDate",
              "operator": "eq"
            }
          },
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff who took attendance.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SectionAttendanceTakenEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/sectionAttendanceTakenEvents/{id}": {
      "get": {
        "operationId": "getSectionAttendanceTakenEvent",
        "summary": "Get a section attendance taken event by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section Attendance Taken Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SectionAttendanceTakenEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (section_attendance_taken_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSectionAttendanceTakenEvent",
        "summary": "Update a section attendance taken event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section Attendance Taken Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSectionAttendanceTakenEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SectionAttendanceTakenEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (section_attendance_taken_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSectionAttendanceTakenEvent",
        "summary": "Soft-delete a section attendance taken event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Section Attendance Taken Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Section attendance taken event soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (section_attendance_taken_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/sessions": {
      "get": {
        "operationId": "listSessions",
        "summary": "List sessions",
        "description": "Returns all sessions for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Session"
        ],
        "parameters": [
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only sessions modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Session"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createSession",
        "summary": "Create a session",
        "description": "Creates a new session record by writing through into the oneroster:academicSession master.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Session"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSessionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Session"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/sessions/{id}": {
      "get": {
        "operationId": "getSession",
        "summary": "Get a session",
        "description": "Returns a single session by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Session"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The session's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Session"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (session_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSession",
        "summary": "Update a session",
        "description": "Updates a session record. Shared roster fields (sessionName, beginDate, endDate, schoolYear, schoolSourcedId) require edfi:write-shared.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Session"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The session's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSessionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Session"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (session_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSession",
        "summary": "Delete a session",
        "description": "Soft-deletes a session record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Session"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The session's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Session soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (session_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/sourceDimensions": {
      "post": {
        "operationId": "createSourceDimension",
        "summary": "Create a source dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Source Dimension"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSourceDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSourceDimensions",
        "summary": "List source dimension records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Source Dimension"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "description": "Filter by code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "code",
              "operator": "eq"
            }
          },
          {
            "name": "fiscalYear",
            "in": "query",
            "description": "Filter by fiscalYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "fiscalYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SourceDimension"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/sourceDimensions/{id}": {
      "get": {
        "operationId": "getSourceDimension",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Source Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (source_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSourceDimension",
        "summary": "Update a source dimension",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Source Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSourceDimensionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceDimension"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (source_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSourceDimension",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Source Dimension"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (source_dimension_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffs": {
      "post": {
        "operationId": "createStaff",
        "summary": "Create a staff member",
        "description": "Creates an Ed-Fi staff record by writing through into the oneroster:user master. If the roster user already exists, adopts it (sets Ed-Fi extends on that row) instead of inserting a duplicate PK.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "staffSourcedId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "The OneRoster user sourcedId that anchors this staff member's roster identity. Shared roster field — UPDATE requires edfi:write-shared."
                  },
                  "firstName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "The staff member's legal first name (OneRoster given name). Shared roster field — UPDATE requires edfi:write-shared."
                  },
                  "lastSurname": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "The staff member's legal last/surname (OneRoster family name). Shared roster field — UPDATE requires edfi:write-shared."
                  },
                  "middleName": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 256,
                    "description": "The staff member's middle name, if any. Shared roster field — UPDATE requires edfi:write-shared."
                  },
                  "staffUniqueId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 32,
                    "description": "A unique alphanumeric code assigned to a staff member by the district. Ed-Fi-owned extends field; second component of the derived-hash GUID."
                  },
                  "staffGenerationCodeSuffix": {
                    "type": "string",
                    "maxLength": 10,
                    "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III). Stored under a staff-prefixed column because edfi:student also extends oneroster:user with a generationCodeSuffix field; exposed on the wire as generationCodeSuffix."
                  },
                  "staffMaidenName": {
                    "type": "string",
                    "maxLength": 75,
                    "description": "The staff member's maiden name, if applicable. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as maidenName."
                  },
                  "staffPersonalTitlePrefix": {
                    "type": "string",
                    "maxLength": 30,
                    "description": "A prefix used to denote the title, degree, position, or seniority of the staff member. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as personalTitlePrefix."
                  },
                  "staffBirthDate": {
                    "type": "string",
                    "format": "date",
                    "description": "The month, day, and year on which the staff member was born. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as birthDate."
                  },
                  "staffSexDescriptor": {
                    "type": "string",
                    "maxLength": 306,
                    "description": "The staff member's sex at birth. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as sexDescriptor."
                  },
                  "hispanicLatinoEthnicity": {
                    "type": "boolean",
                    "description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central and South America, and other Spanish cultures."
                  },
                  "highestCompletedLevelOfEducationDescriptor": {
                    "type": "string",
                    "maxLength": 306,
                    "description": "The extent of formal instruction an individual has received (e.g., the highest grade in school completed or its equivalent or the highest degree received)."
                  },
                  "yearsOfPriorProfessionalExperience": {
                    "type": "number",
                    "description": "The total number of years that an individual has previously held a similar professional position in one or more education institutions."
                  },
                  "yearsOfPriorTeachingExperience": {
                    "type": "number",
                    "description": "The total number of years that an individual has previously held a teaching position in one or more education institutions."
                  },
                  "loginId": {
                    "type": "string",
                    "maxLength": 60,
                    "description": "The login identifier for the staff member, if applicable."
                  },
                  "highlyQualifiedTeacher": {
                    "type": "boolean",
                    "description": "An indication of whether a teacher is classified as highly qualified for his/her assignment according to state definition."
                  },
                  "staffCitizenshipStatusDescriptor": {
                    "type": "string",
                    "maxLength": 306,
                    "description": "An indicator of whether or not the person is a U.S. citizen. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as citizenshipStatusDescriptor."
                  },
                  "oldEthnicityDescriptor": {
                    "type": "string",
                    "maxLength": 306,
                    "description": "Previous definition of ethnicity combining combos of race and ethnicity."
                  },
                  "addresses": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "addressTypeDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                        },
                        "city": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 30,
                          "description": "The name of the city in which the address is located."
                        },
                        "postalCode": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 17,
                          "description": "The five or nine digit zip code or overseas postal code portion of an address."
                        },
                        "streetNumberName": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 150,
                          "description": "The street number and name of the address."
                        },
                        "stateAbbreviationDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The abbreviation for the state or jurisdiction in which the address is located."
                        },
                        "apartmentRoomSuiteNumber": {
                          "type": "string",
                          "maxLength": 50,
                          "description": "The apartment, room, or suite number of an address."
                        },
                        "buildingSiteNumber": {
                          "type": "string",
                          "maxLength": 20,
                          "description": "The number of the building on the site, if more than one building shares the same address."
                        },
                        "nameOfCounty": {
                          "type": "string",
                          "maxLength": 30,
                          "description": "The name of the county, parish, borough, or comparable unit of the address."
                        },
                        "countyFIPSCode": {
                          "type": "string",
                          "maxLength": 5,
                          "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                        },
                        "latitude": {
                          "type": "string",
                          "maxLength": 20,
                          "description": "The geographic latitude of the physical address."
                        },
                        "longitude": {
                          "type": "string",
                          "maxLength": 20,
                          "description": "The geographic longitude of the physical address."
                        },
                        "doNotPublishIndicator": {
                          "type": "boolean",
                          "description": "An indication that the address should not be published."
                        },
                        "congressionalDistrict": {
                          "type": "string",
                          "maxLength": 30,
                          "description": "The congressional district in which the address is located."
                        },
                        "localeDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                        }
                      },
                      "required": [
                        "addressTypeDescriptor",
                        "city",
                        "postalCode",
                        "streetNumberName",
                        "stateAbbreviationDescriptor"
                      ]
                    },
                    "description": "A postal address associated with a staff member, discriminated by address type. Multiple addresses per staff member are supported (home, mailing, physical, etc.). Items unique by (addressTypeDescriptor, city, postalCode, streetNumberName, stateAbbreviationDescriptor)."
                  },
                  "staffCharacteristics": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "staffCharacteristicDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The characteristic or trait attributed to the staff member."
                        },
                        "beginDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the characteristic was designated."
                        },
                        "endDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the characteristic was removed or no longer applicable."
                        },
                        "designatedBy": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The person, organization, or department that designated the characteristic."
                        }
                      },
                      "required": [
                        "staffCharacteristicDescriptor"
                      ]
                    },
                    "description": "A characteristic or trait attributed to the staff member (e.g., Migrant, Homeless, Displaced Homemaker), discriminated by characteristic descriptor. Items unique by (staffCharacteristicDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as characteristics."
                  },
                  "credentials": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "credentialIdentifier": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60,
                          "description": "Identifier or serial number assigned to the credential."
                        },
                        "stateOfIssueStateAbbreviationDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The abbreviation for the name of the state that issued the credential."
                        },
                        "credentialFieldDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "The field of certification for the credential (e.g., Mathematics, Early Childhood)."
                        },
                        "credentialTypeDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "An indication of the category of credential an individual holds (e.g., Certification, Endorsement)."
                        },
                        "levelDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "The grade level(s) certified for the credential."
                        },
                        "teachingCredentialDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "An indication of the category of a legal document giving authorization to perform teaching assignment services."
                        },
                        "issuanceDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The month, day, and year on which an active credential was issued to an individual."
                        },
                        "expirationDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The month, day, and year on which an active credential held by an individual will expire."
                        },
                        "teachingCredentialBasisDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "An indication of the pre-determined criteria for granting the teaching credential that an individual holds."
                        }
                      },
                      "required": [
                        "credentialIdentifier",
                        "stateOfIssueStateAbbreviationDescriptor"
                      ]
                    },
                    "description": "A credential (license, certificate, endorsement) held by a staff member, discriminated by credential identifier and state of issue. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
                  },
                  "staffElectronicMails": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "electronicMailTypeDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                        },
                        "electronicMailAddress": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "The electronic mail (e-mail) address for the staff member."
                        },
                        "primaryEmailAddressIndicator": {
                          "type": "boolean",
                          "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the staff member."
                        },
                        "doNotPublishIndicator": {
                          "type": "boolean",
                          "description": "An indication that the electronic mail address should not be published."
                        }
                      },
                      "required": [
                        "electronicMailTypeDescriptor",
                        "electronicMailAddress"
                      ]
                    },
                    "description": "An electronic mail (e-mail) address associated with a staff member, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as electronicMails."
                  },
                  "staffIdentificationDocuments": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "identificationDocumentUseDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                        },
                        "personalInformationVerificationDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                        },
                        "documentTitle": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The title of the document given by the issuer."
                        },
                        "documentExpirationDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The day when the document expires, if applicable."
                        },
                        "issuerDocumentIdentificationCode": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The unique identifier on the issuer's identification system."
                        },
                        "issuerName": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "Name of the entity or institution that issued the document."
                        },
                        "issuerCountryDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "Country of the issuing entity."
                        }
                      },
                      "required": [
                        "identificationDocumentUseDescriptor",
                        "personalInformationVerificationDescriptor"
                      ]
                    },
                    "description": "An official document used to verify a staff member's identity, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as identificationDocuments."
                  },
                  "staffInternationalAddresses": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "addressTypeDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                        },
                        "addressLine1": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 150,
                          "description": "The first line of the address."
                        },
                        "addressLine2": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "The second line of the address."
                        },
                        "addressLine3": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "The third line of the address."
                        },
                        "addressLine4": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "The fourth line of the address."
                        },
                        "countryDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The name of the country."
                        },
                        "latitude": {
                          "type": "string",
                          "maxLength": 20,
                          "description": "The geographic latitude of the physical address."
                        },
                        "longitude": {
                          "type": "string",
                          "maxLength": 20,
                          "description": "The geographic longitude of the physical address."
                        },
                        "beginDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The first date the address is valid."
                        },
                        "endDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The last date the address is valid."
                        }
                      },
                      "required": [
                        "addressTypeDescriptor",
                        "addressLine1",
                        "countryDescriptor"
                      ]
                    },
                    "description": "An international (non-U.S.) address associated with a staff member, discriminated by address type. Items unique by (addressTypeDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as internationalAddresses."
                  },
                  "languageUses": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "languageDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "A specification of which ISO 639-3 language."
                        },
                        "languageUseDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "A description of how the language is used (e.g., Home language, Dominant language, Correspondence language)."
                        }
                      },
                      "required": [
                        "languageDescriptor",
                        "languageUseDescriptor"
                      ]
                    },
                    "description": "A description of how the language is used by the staff member (e.g., spoken, written, correspondence), discriminated by language and use descriptors. Items unique by (languageDescriptor, languageUseDescriptor)."
                  },
                  "languages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "languageDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "A specification of which ISO 639-3 language the staff member speaks or understands."
                        }
                      },
                      "required": [
                        "languageDescriptor"
                      ]
                    },
                    "description": "A language spoken or understood by the staff member, discriminated by language descriptor. Items unique by (languageDescriptor)."
                  },
                  "staffOtherNames": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "otherNameTypeDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The types of alternate names for a staff member (e.g., Alias, Nickname, Previous Legal Name)."
                        },
                        "firstName": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 75,
                          "description": "The staff member's first name in this alternate identity."
                        },
                        "middleName": {
                          "type": "string",
                          "maxLength": 75,
                          "description": "The staff member's middle name in this alternate identity."
                        },
                        "lastSurname": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 75,
                          "description": "The staff member's last name/surname in this alternate identity."
                        },
                        "generationCodeSuffix": {
                          "type": "string",
                          "maxLength": 10,
                          "description": "An appendage, if any, used to denote the individual's generation."
                        },
                        "personalTitlePrefix": {
                          "type": "string",
                          "maxLength": 30,
                          "description": "A prefix used to denote the title, degree, position, or seniority."
                        }
                      },
                      "required": [
                        "otherNameTypeDescriptor",
                        "firstName",
                        "lastSurname"
                      ]
                    },
                    "description": "An alternative name by which the staff member is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as otherNames."
                  },
                  "staffPersonalIdentificationDocuments": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "identificationDocumentUseDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                        },
                        "personalInformationVerificationDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                        },
                        "documentTitle": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The title of the document given by the issuer."
                        },
                        "documentExpirationDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The day when the document expires, if applicable."
                        },
                        "issuerDocumentIdentificationCode": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The unique identifier on the issuer's identification system."
                        },
                        "issuerName": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "Name of the entity or institution that issued the document."
                        },
                        "issuerCountryDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "Country of the issuing entity."
                        }
                      },
                      "required": [
                        "identificationDocumentUseDescriptor",
                        "personalInformationVerificationDescriptor"
                      ]
                    },
                    "description": "A personal identification document presented by a staff member for verification purposes, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as personalIdentificationDocuments."
                  },
                  "races": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "raceDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The general racial category which most clearly reflects the individual's recognition of their community or with which the individual most identifies."
                        }
                      },
                      "required": [
                        "raceDescriptor"
                      ]
                    },
                    "description": "A race designation for the staff member as reported to the education organization, allowing multiple race entries per staff member. Items unique by (raceDescriptor)."
                  },
                  "recognitions": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "recognitionTypeDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The nature of recognition given to the staff member for accomplishments in a co-curricular, or extra-curricular activity."
                        },
                        "achievementTitle": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The title assigned to the achievement."
                        },
                        "achievementCategoryDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "The category of achievement attributed to the individual."
                        },
                        "achievementCategorySystem": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The system that defines the categories of achievement for the individual."
                        },
                        "issuerName": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "The name of the agent issuing the recognition."
                        },
                        "issuerOriginURL": {
                          "type": "string",
                          "maxLength": 255,
                          "description": "The Uniform Resource Locator (URL) from which the recognition was issued."
                        },
                        "criteria": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "The criteria for competency-based completion of the achievement/award."
                        },
                        "criteriaURL": {
                          "type": "string",
                          "maxLength": 255,
                          "description": "The Uniform Resource Locator (URL) for the unique address of a web page describing the competency-based completion criteria."
                        },
                        "evidenceStatement": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "A statement or reference describing the evidence that the individual met the criteria for attainment of the achievement."
                        },
                        "imageURL": {
                          "type": "string",
                          "maxLength": 255,
                          "description": "The Uniform Resource Locator (URL) for the unique address of an image representing an award or badge associated with the achievement."
                        },
                        "recognitionDescription": {
                          "type": "string",
                          "maxLength": 80,
                          "description": "A description of the type of academic distinctions earned by or awarded to the individual."
                        },
                        "recognitionAwardDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the recognition was awarded or earned."
                        },
                        "recognitionAwardExpiresDate": {
                          "type": "string",
                          "format": "date",
                          "description": "Date on which the recognition expires."
                        }
                      },
                      "required": [
                        "recognitionTypeDescriptor"
                      ]
                    },
                    "description": "A recognition or award given to the staff member, discriminated by recognition type. Items unique by (recognitionTypeDescriptor)."
                  },
                  "telephones": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "telephoneNumberTypeDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The type of communication number listed for the staff member (e.g., Home, Mobile, Work)."
                        },
                        "telephoneNumber": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 24,
                          "description": "The telephone number including the area code, and extension, if applicable."
                        },
                        "orderOfPriority": {
                          "type": "integer",
                          "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                        },
                        "textMessageCapabilityIndicator": {
                          "type": "boolean",
                          "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                        },
                        "doNotPublishIndicator": {
                          "type": "boolean",
                          "description": "An indication that the telephone number should not be published."
                        }
                      },
                      "required": [
                        "telephoneNumberTypeDescriptor",
                        "telephoneNumber"
                      ]
                    },
                    "description": "A telephone number associated with a staff member, discriminated by telephone number type. Items unique by (telephoneNumberTypeDescriptor, telephoneNumber)."
                  },
                  "tribalAffiliations": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "tribalAffiliationDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "An American Indian tribe with which the staff member is affiliated."
                        }
                      },
                      "required": [
                        "tribalAffiliationDescriptor"
                      ]
                    },
                    "description": "A tribal affiliation held by the staff member, discriminated by tribal affiliation descriptor. Items unique by (tribalAffiliationDescriptor)."
                  },
                  "staffVisas": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "visaDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "An indicator of a non-U.S. citizen's visa type."
                        }
                      },
                      "required": [
                        "visaDescriptor"
                      ]
                    },
                    "description": "A visa type held by the staff member, discriminated by visa descriptor. Items unique by (visaDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as visas."
                  },
                  "staffRecordState": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "canonical",
                      "rejected",
                      "soft_deleted"
                    ],
                    "description": "Lifecycle state of this staff record. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as recordState."
                  },
                  "staffDeleteSource": {
                    "type": "string",
                    "enum": [
                      "api",
                      "import",
                      "correction",
                      "retention_policy"
                    ],
                    "description": "The origin of the soft-delete action. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as deleteSource."
                  },
                  "birthDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Staff birth date (maps to staff_birth_date)."
                  }
                },
                "required": [
                  "staffSourcedId",
                  "firstName",
                  "lastSurname",
                  "staffUniqueId",
                  "birthDate"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Staff"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaff",
        "summary": "List staff members",
        "description": "Lists staff demographic records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff"
        ],
        "parameters": [
          {
            "name": "lastSurname",
            "in": "query",
            "description": "Filter by last surname.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "lastSurname",
              "operator": "eq"
            }
          },
          {
            "name": "firstName",
            "in": "query",
            "description": "Filter by first name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "firstName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only staff modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Staff"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffs/{id}": {
      "get": {
        "operationId": "getStaff",
        "summary": "Get a staff member by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The staff member's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Staff"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaff",
        "summary": "Update a staff member",
        "description": "Updates Ed-Fi-owned extends fields. Shared roster fields (firstName, lastSurname, middleName) require edfi:write-shared.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The staff member's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Staff"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaff",
        "summary": "Soft-delete a staff member",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The staff member's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Staff member soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffAbsenceEvents": {
      "post": {
        "operationId": "createStaffAbsenceEvent",
        "summary": "Create a staff absence event",
        "description": "Creates a staff absence event record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Absence Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffAbsenceEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffAbsenceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffAbsenceEvents",
        "summary": "List staff absence events",
        "description": "Lists staff absence events with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Absence Event"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "eventDate",
            "in": "query",
            "description": "Filter by event date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "eventDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffAbsenceEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffAbsenceEvents/{id}": {
      "get": {
        "operationId": "getStaffAbsenceEvent",
        "summary": "Get a staff absence event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Absence Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffAbsenceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffAbsenceEvent",
        "summary": "Update a staff absence event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Absence Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffAbsenceEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffAbsenceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffAbsenceEvent",
        "summary": "Delete a staff absence event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Absence Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffCohortAssociations": {
      "post": {
        "operationId": "createStaffCohortAssociation",
        "summary": "Create a staff cohort association",
        "description": "Creates an Ed-Fi staff cohort association record linking a staff member to a cohort.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Cohort Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffCohortAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffCohortAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffCohortAssociations",
        "summary": "List staff cohort associations",
        "description": "Lists staff cohort association records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Cohort Association"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "cohortIdentifier",
            "in": "query",
            "description": "Filter by cohort identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "cohortIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only staff cohort associations modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffCohortAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffCohortAssociations/{id}": {
      "get": {
        "operationId": "getStaffCohortAssociation",
        "summary": "Get a staff cohort association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Cohort Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The staff cohort association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffCohortAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_cohort_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffCohortAssociation",
        "summary": "Update a staff cohort association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Cohort Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The staff cohort association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffCohortAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffCohortAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_cohort_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffCohortAssociation",
        "summary": "Soft-delete a staff cohort association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Cohort Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The staff cohort association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Staff cohort association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_cohort_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffDemographics": {
      "post": {
        "operationId": "createStaffDemographic",
        "summary": "Create a staff demographic",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Demographic"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffDemographicRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDemographic"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffDemographics",
        "summary": "List staff demographic records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Demographic"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staffSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffDemographic"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffDemographics/{id}": {
      "get": {
        "operationId": "getStaffDemographic",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Demographic"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDemographic"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_demographic_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffDemographic",
        "summary": "Update a staff demographic",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Demographic"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffDemographicRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDemographic"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_demographic_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffDemographic",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Demographic"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_demographic_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffDirectories": {
      "post": {
        "operationId": "createStaffDirectory",
        "summary": "Create a staff directory",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Directory"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffDirectoryRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDirectory"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffDirectories",
        "summary": "List staff directory records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Directory"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staffSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffDirectory"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffDirectories/{id}": {
      "get": {
        "operationId": "getStaffDirectory",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Directory"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDirectory"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_directory_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffDirectory",
        "summary": "Update a staff directory",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Directory"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffDirectoryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDirectory"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_directory_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffDirectory",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Directory"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_directory_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffDisciplineIncidentAssociations": {
      "post": {
        "operationId": "createStaffDisciplineIncidentAssociation",
        "summary": "Create a staff discipline incident association",
        "description": "Creates a staff discipline incident association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Discipline Incident Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffDisciplineIncidentAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDisciplineIncidentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffDisciplineIncidentAssociations",
        "summary": "List staff discipline incident associations",
        "description": "Lists staff discipline incident associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Discipline Incident Association"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "incidentIdentifier",
            "in": "query",
            "description": "Filter by incident identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "incidentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffDisciplineIncidentAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffDisciplineIncidentAssociations/{id}": {
      "get": {
        "operationId": "getStaffDisciplineIncidentAssociation",
        "summary": "Get a staff discipline incident association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Discipline Incident Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDisciplineIncidentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffDisciplineIncidentAssociation",
        "summary": "Update a staff discipline incident association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Discipline Incident Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffDisciplineIncidentAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffDisciplineIncidentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffDisciplineIncidentAssociation",
        "summary": "Delete a staff discipline incident association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Discipline Incident Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffEducationOrganizationAssignmentAssociations": {
      "post": {
        "operationId": "createStaffEducationOrganizationAssignmentAssociation",
        "summary": "Create a staff education organization assignment association",
        "description": "Creates an assignment record associating a staff member with an education organization for an effective period. The (staffSourcedId, educationOrganizationSourcedId, staffClassificationDescriptor, beginDate) tuple must be unique; overlapping periods for the same subject are rejected.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Assignment Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffEducationOrganizationAssignmentAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducationOrganizationAssignmentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffEducationOrganizationAssignmentAssociations",
        "summary": "List staff education organization assignment associations",
        "description": "Lists staff assignment records, optionally filtered by staff, organization, classification, or effective date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Assignment Association"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "staffClassificationDescriptor",
            "in": "query",
            "description": "Filter by staff classification descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffClassificationDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffEducationOrganizationAssignmentAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffEducationOrganizationAssignmentAssociations/{id}": {
      "get": {
        "operationId": "getStaffEducationOrganizationAssignmentAssociation",
        "summary": "Get a staff education organization assignment association",
        "description": "Returns one staff assignment record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Assignment Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducationOrganizationAssignmentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffEducationOrganizationAssignmentAssociation",
        "summary": "Update a staff education organization assignment association",
        "description": "Updates mutable fields of a staff assignment record (e.g. setting endDate to close the period).\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Assignment Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffEducationOrganizationAssignmentAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducationOrganizationAssignmentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffEducationOrganizationAssignmentAssociation",
        "summary": "Delete a staff education organization assignment association",
        "description": "Soft-deletes a staff assignment record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Assignment Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffEducationOrganizationEmploymentAssociations": {
      "post": {
        "operationId": "createStaffEducationOrganizationEmploymentAssociation",
        "summary": "Create a staff education organization employment association",
        "description": "Creates an employment record associating a staff member with an education organization for an effective period. The (staffSourcedId, educationOrganizationSourcedId, employmentStatusDescriptor, hireDate) tuple must be unique; overlapping periods for the same subject are rejected.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Employment Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffEducationOrganizationEmploymentAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducationOrganizationEmploymentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffEducationOrganizationEmploymentAssociations",
        "summary": "List staff education organization employment associations",
        "description": "Lists staff employment records, optionally filtered by staff, organization, employment status, or hire date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Employment Association"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "employmentStatusDescriptor",
            "in": "query",
            "description": "Filter by employment status descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "employmentStatusDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffEducationOrganizationEmploymentAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffEducationOrganizationEmploymentAssociations/{id}": {
      "get": {
        "operationId": "getStaffEducationOrganizationEmploymentAssociation",
        "summary": "Get a staff education organization employment association",
        "description": "Returns one staff employment record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Employment Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducationOrganizationEmploymentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffEducationOrganizationEmploymentAssociation",
        "summary": "Update a staff education organization employment association",
        "description": "Updates mutable fields of a staff employment record (e.g. setting endDate to close the period, or recording separation details).\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Employment Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffEducationOrganizationEmploymentAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducationOrganizationEmploymentAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffEducationOrganizationEmploymentAssociation",
        "summary": "Delete a staff education organization employment association",
        "description": "Soft-deletes a staff employment record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Education Organization Employment Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffEducatorPreparationProgramAssociations": {
      "post": {
        "operationId": "createStaffEducatorPreparationProgramAssociation",
        "summary": "Create a staff educator preparation program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Educator Preparation Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffEducatorPreparationProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducatorPreparationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffEducatorPreparationProgramAssociations",
        "summary": "List staff educator preparation program association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Educator Preparation Program Association"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staffSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by programName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffEducatorPreparationProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffEducatorPreparationProgramAssociations/{id}": {
      "get": {
        "operationId": "getStaffEducatorPreparationProgramAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Educator Preparation Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducatorPreparationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_educator_preparation_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffEducatorPreparationProgramAssociation",
        "summary": "Update a staff educator preparation program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Educator Preparation Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffEducatorPreparationProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffEducatorPreparationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_educator_preparation_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffEducatorPreparationProgramAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Educator Preparation Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_educator_preparation_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffIdentificationCodes": {
      "post": {
        "operationId": "createStaffIdentificationCode",
        "summary": "Create a staff identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Identification Code"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffIdentificationCodes",
        "summary": "List staff identification codes",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Identification Code"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff member.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffIdentificationCode"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffIdentificationCodes/{id}": {
      "get": {
        "operationId": "getStaffIdentificationCode",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffIdentificationCode",
        "summary": "Update a staff identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffIdentificationCode",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (staff_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffLeaves": {
      "post": {
        "operationId": "createStaffLeave",
        "summary": "Create a staff leave",
        "description": "Creates a staff leave record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Leave"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffLeaveRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffLeave"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffLeaves",
        "summary": "List staff leaves",
        "description": "Lists staff leaves with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Leave"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "beginDate",
            "in": "query",
            "description": "Filter by begin date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "beginDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffLeave"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffLeaves/{id}": {
      "get": {
        "operationId": "getStaffLeave",
        "summary": "Get a staff leave",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Leave"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffLeave"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffLeave",
        "summary": "Update a staff leave",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Leave"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffLeaveRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffLeave"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffLeave",
        "summary": "Delete a staff leave",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Leave"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffProgramAssociations": {
      "post": {
        "operationId": "createStaffProgramAssociation",
        "summary": "Create a staff program association",
        "description": "Creates a staff program association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffProgramAssociations",
        "summary": "List staff program associations",
        "description": "Lists staff program associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Program Association"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffProgramAssociations/{id}": {
      "get": {
        "operationId": "getStaffProgramAssociation",
        "summary": "Get a staff program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffProgramAssociation",
        "summary": "Update a staff program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffProgramAssociation",
        "summary": "Delete a staff program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffSchoolAssociations": {
      "post": {
        "operationId": "createStaffSchoolAssociation",
        "summary": "Create a staff school association",
        "description": "Creates an assignment record associating a staff member with a school for an effective period. The (staffSourcedId, schoolSourcedId, programAssignmentDescriptor) tuple must be unique; overlapping periods for the same subject are rejected.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff School Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffSchoolAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffSchoolAssociations",
        "summary": "List staff school associations",
        "description": "Lists staff assignment records, optionally filtered by staff, school, program, or effective date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff School Association"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programAssignmentDescriptor",
            "in": "query",
            "description": "Filter by program assignment descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programAssignmentDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffSchoolAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffSchoolAssociations/{id}": {
      "get": {
        "operationId": "getStaffSchoolAssociation",
        "summary": "Get a staff school association",
        "description": "Returns one staff school assignment record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffSchoolAssociation",
        "summary": "Update a staff school association",
        "description": "Updates mutable fields of a staff school assignment record (e.g. setting endDate to close the period).\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffSchoolAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffSchoolAssociation",
        "summary": "Delete a staff school association",
        "description": "Soft-deletes a staff school assignment record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffSectionAssociations": {
      "post": {
        "operationId": "createStaffSectionAssociation",
        "summary": "Create a staff section association",
        "description": "Creates an assignment record associating a staff member with a class section for an effective period. The (staffSourcedId, classSourcedId, beginDate) tuple must be unique; overlapping periods for the same subject are rejected.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Section Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStaffSectionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStaffSectionAssociations",
        "summary": "List staff section associations",
        "description": "Lists staff section assignment records, optionally filtered by staff, class, or effective date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Section Association"
        ],
        "parameters": [
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "classSourcedId",
            "in": "query",
            "description": "Filter by class sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "classSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "beginDate",
            "in": "query",
            "description": "Filter by exact begin date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "beginDate",
              "operator": "eq"
            }
          },
          {
            "name": "classroomPositionDescriptor",
            "in": "query",
            "description": "Filter by classroom position.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "classroomPositionDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StaffSectionAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/staffSectionAssociations/{id}": {
      "get": {
        "operationId": "getStaffSectionAssociation",
        "summary": "Get a staff section association",
        "description": "Returns one staff section assignment record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStaffSectionAssociation",
        "summary": "Update a staff section association",
        "description": "Updates mutable fields of a staff section assignment record (e.g. setting endDate to close the period, adjusting percentageContribution).\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStaffSectionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StaffSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStaffSectionAssociation",
        "summary": "Delete a staff section association",
        "description": "Soft-deletes a staff section assignment record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Staff Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/stateEducationAgencies": {
      "get": {
        "operationId": "listStateEducationAgencies",
        "summary": "List state education agencies",
        "description": "Returns all state education agencies for the authenticated tenant, with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "State Education Agency"
        ],
        "parameters": [
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only SEAs modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StateEducationAgency"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createStateEducationAgency",
        "summary": "Create a state education agency",
        "description": "Creates a new state education agency record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "State Education Agency"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStateEducationAgencyRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StateEducationAgency"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/stateEducationAgencies/{id}": {
      "get": {
        "operationId": "getStateEducationAgency",
        "summary": "Get a state education agency",
        "description": "Returns a single state education agency by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "State Education Agency"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The SEA's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StateEducationAgency"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (state_education_agency_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStateEducationAgency",
        "summary": "Update a state education agency",
        "description": "Updates mutable fields of a state education agency record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "State Education Agency"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The SEA's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStateEducationAgencyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StateEducationAgency"
                }
              }
            },
            "headers": {
              "ETag": {
                "description": "The resource's current entity-tag (RFC 9110, quoted). Send it back in If-Match on the next write (optimistic concurrency).",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (state_education_agency_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStateEducationAgency",
        "summary": "Delete a state education agency",
        "description": "Soft-deletes a state education agency record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "State Education Agency"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The SEA's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The resource's current ETag (from the last GET/write response), quoted per RFC 9110. REQUIRED — absent returns 428; a stale ETag returns 412 (refetch and retry). Send `*` to overwrite unconditionally.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "State education agency soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (state_education_agency_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "412": {
            "description": "Precondition Failed — the If-Match ETag is stale (the resource was modified); refetch and retry.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "428": {
            "description": "Precondition Required — this write requires the If-Match header (send the resource's ETag).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/students": {
      "post": {
        "operationId": "createStudent",
        "summary": "Create a student",
        "description": "Creates an Ed-Fi student by writing through into the oneroster:user master. If the roster user already exists, adopts it (sets Ed-Fi extends on that row) instead of inserting a duplicate PK.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "studentSourcedId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "The OneRoster user sourcedId that anchors this student's roster identity. Shared roster field — UPDATE requires edfi:write-shared."
                  },
                  "firstName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "The student's legal first name (OneRoster given name). Shared roster field — UPDATE requires edfi:write-shared."
                  },
                  "lastSurname": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "The student's legal last/surname (OneRoster family name). Shared roster field — UPDATE requires edfi:write-shared."
                  },
                  "middleName": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 256,
                    "description": "The student's middle name, if any. Shared roster field — UPDATE requires edfi:write-shared."
                  },
                  "generationCodeSuffix": {
                    "type": "string",
                    "maxLength": 10,
                    "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III)."
                  },
                  "maidenName": {
                    "type": "string",
                    "maxLength": 75,
                    "description": "The student's maiden name, if applicable."
                  },
                  "personalTitlePrefix": {
                    "type": "string",
                    "maxLength": 30,
                    "description": "A prefix used to denote the title, degree, position, or seniority of the student."
                  },
                  "birthDate": {
                    "type": "string",
                    "format": "date",
                    "description": "The month, day, and year on which the student was born."
                  },
                  "birthCity": {
                    "type": "string",
                    "maxLength": 30,
                    "description": "The city the student was born in."
                  },
                  "birthStateAbbreviationDescriptor": {
                    "type": "string",
                    "maxLength": 306,
                    "description": "The abbreviation for the name of the state (within the United States) or extra-state jurisdiction in which the student was born."
                  },
                  "birthInternationalProvince": {
                    "type": "string",
                    "maxLength": 150,
                    "description": "For students born outside of the U.S., the Province or jurisdiction in which the student was born."
                  },
                  "birthCountryDescriptor": {
                    "type": "string",
                    "maxLength": 306,
                    "description": "The country in which the student was born."
                  },
                  "dateEnteredUS": {
                    "type": "string",
                    "format": "date",
                    "description": "For students born outside of the U.S., the date the student entered the U.S."
                  },
                  "multipleBirthStatus": {
                    "type": "boolean",
                    "description": "Indicator of whether the student was born with other babies as part of a multiple birth."
                  },
                  "sexDescriptor": {
                    "type": "string",
                    "maxLength": 306,
                    "description": "The student's birth sex as reported to the education organization."
                  },
                  "citizenshipStatusDescriptor": {
                    "type": "string",
                    "maxLength": 306,
                    "description": "An indicator of whether or not the student is a U.S. citizen."
                  },
                  "characteristics": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "studentCharacteristicDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The characteristic attributed to the student."
                        },
                        "designatedBy": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The person, organization, or department that designated the characteristic."
                        },
                        "beginDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the characteristic was designated."
                        },
                        "endDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the characteristic was removed or became inactive."
                        }
                      },
                      "required": [
                        "studentCharacteristicDescriptor"
                      ]
                    },
                    "description": "A characteristic or trait attributed to the student (e.g., homeless, migrant, immigrant, displaced homemaker), with optional effective date range. Items unique by (studentCharacteristicDescriptor)."
                  },
                  "cohortYears": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "cohortYearTypeDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The type of cohort year (e.g., Ninth grade, Expected graduation)."
                        },
                        "schoolYear": {
                          "type": "integer",
                          "minimum": 1900,
                          "maximum": 2100,
                          "description": "The school year associated with this cohort designation."
                        }
                      },
                      "required": [
                        "cohortYearTypeDescriptor",
                        "schoolYear"
                      ]
                    },
                    "description": "A cohort year classification for the student, indicating the school year cohort the student entered or is expected to graduate from. Items unique by (cohortYearTypeDescriptor, schoolYear)."
                  },
                  "disabilityDesignations": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "disabilityDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "A disability category to which the student belongs."
                        },
                        "disabilityDesignationDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The specific designation (e.g., Section 504 Coverage, IDEA Part B Eligible)."
                        }
                      },
                      "required": [
                        "disabilityDescriptor",
                        "disabilityDesignationDescriptor"
                      ]
                    },
                    "description": "A disability designation for a student, providing the specific designation associated with a disability descriptor (e.g., IDEA qualification, 504 plan). Items unique by (disabilityDescriptor, disabilityDesignationDescriptor)."
                  },
                  "educationPlans": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "educationPlanTypeDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The type of education plan (e.g., IEP, 504 Plan, Gifted and Talented)."
                        }
                      },
                      "required": [
                        "educationPlanTypeDescriptor"
                      ]
                    },
                    "description": "An education plan assigned to the student (e.g., IEP, 504 Plan, Career Pathway). Items unique by (educationPlanTypeDescriptor)."
                  },
                  "electronicMails": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "electronicMailTypeDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                        },
                        "electronicMailAddress": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "The electronic mail (e-mail) address for the student."
                        },
                        "primaryEmailAddressIndicator": {
                          "type": "boolean",
                          "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the student."
                        },
                        "doNotPublishIndicator": {
                          "type": "boolean",
                          "description": "An indication that the electronic mail address should not be published."
                        }
                      },
                      "required": [
                        "electronicMailTypeDescriptor",
                        "electronicMailAddress"
                      ]
                    },
                    "description": "An electronic mail (e-mail) address associated with a student, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress)."
                  },
                  "identificationDocuments": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "identificationDocumentUseDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                        },
                        "personalInformationVerificationDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                        },
                        "documentTitle": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The title of the document given by the issuer."
                        },
                        "documentExpirationDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The day when the document expires, if applicable."
                        },
                        "issuerDocumentIdentificationCode": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The unique identifier on the issuer's identification system."
                        },
                        "issuerName": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "Name of the entity or institution that issued the document."
                        },
                        "issuerCountryDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "Country of the issuing entity."
                        }
                      },
                      "required": [
                        "identificationDocumentUseDescriptor",
                        "personalInformationVerificationDescriptor"
                      ]
                    },
                    "description": "An official document used to verify a student's identity, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
                  },
                  "indicators": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "indicatorName": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "description": "The name of the indicator or metric."
                        },
                        "indicator": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The value of the indicator or metric."
                        },
                        "indicatorGroup": {
                          "type": "string",
                          "maxLength": 200,
                          "description": "The name for a group of indicators."
                        },
                        "designatedBy": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The person, organization, or department that designated the characteristic."
                        },
                        "beginDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the indicator was assigned to the student."
                        },
                        "endDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the indicator was removed."
                        }
                      },
                      "required": [
                        "indicatorName"
                      ]
                    },
                    "description": "A named indicator or metric associated with a student (e.g., at-risk, gifted and talented), with optional effective date range. Items unique by (indicatorName)."
                  },
                  "internationalAddresses": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "addressTypeDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The type of address (e.g., Physical, Mailing, Home, Temporary)."
                        },
                        "addressLine1": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 150,
                          "description": "The first line of the address."
                        },
                        "addressLine2": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "The second line of the address."
                        },
                        "addressLine3": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "The third line of the address."
                        },
                        "addressLine4": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "The fourth line of the address."
                        },
                        "countryDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The name of the country."
                        },
                        "latitude": {
                          "type": "string",
                          "maxLength": 20,
                          "description": "The geographic latitude of the physical address."
                        },
                        "longitude": {
                          "type": "string",
                          "maxLength": 20,
                          "description": "The geographic longitude of the physical address."
                        },
                        "beginDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The first date the address is valid."
                        },
                        "endDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The last date the address is valid."
                        }
                      },
                      "required": [
                        "addressTypeDescriptor",
                        "addressLine1",
                        "countryDescriptor"
                      ]
                    },
                    "description": "An international (non-U.S.) address associated with a student, discriminated by address type. Items unique by (addressTypeDescriptor)."
                  },
                  "migrantEducationProgramServices": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "migrantEducationProgramServiceDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The migrant education program service provided to the student."
                        },
                        "primaryIndicator": {
                          "type": "boolean",
                          "description": "True if this is the primary service being provided to the migrant student."
                        },
                        "serviceBeginDate": {
                          "type": "string",
                          "format": "date",
                          "description": "First date the student began receiving this service."
                        },
                        "serviceEndDate": {
                          "type": "string",
                          "format": "date",
                          "description": "Last date the student received this service."
                        }
                      },
                      "required": [
                        "migrantEducationProgramServiceDescriptor"
                      ]
                    },
                    "description": "A migrant education program service provided to the student, discriminated by service descriptor. Items unique by (migrantEducationProgramServiceDescriptor)."
                  },
                  "otherNames": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "otherNameTypeDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The types of alternate names for a student (e.g., Alias, Nickname, Previous Legal Name)."
                        },
                        "firstName": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 75,
                          "description": "The student's first name in this alternate identity."
                        },
                        "middleName": {
                          "type": "string",
                          "maxLength": 75,
                          "description": "The student's middle name in this alternate identity."
                        },
                        "lastSurname": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 75,
                          "description": "The student's last name/surname in this alternate identity."
                        },
                        "generationCodeSuffix": {
                          "type": "string",
                          "maxLength": 10,
                          "description": "An appendage, if any, used to denote the individual's generation."
                        },
                        "personalTitlePrefix": {
                          "type": "string",
                          "maxLength": 30,
                          "description": "A prefix used to denote the title, degree, position, or seniority."
                        }
                      },
                      "required": [
                        "otherNameTypeDescriptor",
                        "firstName",
                        "lastSurname"
                      ]
                    },
                    "description": "An alternative name by which the student is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor)."
                  },
                  "personalIdentificationDocuments": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "identificationDocumentUseDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The primary function of the document used for establishing identity."
                        },
                        "personalInformationVerificationDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "The category of the document relative to its purpose."
                        },
                        "documentTitle": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The title of the document given by the issuer."
                        },
                        "documentExpirationDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The day when the document expires, if applicable."
                        },
                        "issuerDocumentIdentificationCode": {
                          "type": "string",
                          "maxLength": 60,
                          "description": "The unique identifier on the issuer's identification system."
                        },
                        "issuerName": {
                          "type": "string",
                          "maxLength": 150,
                          "description": "Name of the entity or institution that issued the document."
                        },
                        "issuerCountryDescriptor": {
                          "type": "string",
                          "maxLength": 306,
                          "description": "Country of the issuing entity."
                        }
                      },
                      "required": [
                        "identificationDocumentUseDescriptor",
                        "personalInformationVerificationDescriptor"
                      ]
                    },
                    "description": "A personal identification document presented by the student for identity verification purposes, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
                  },
                  "visas": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "visaDescriptor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 306,
                          "description": "An indicator of a non-U.S. citizen's Visa type."
                        }
                      },
                      "required": [
                        "visaDescriptor"
                      ]
                    },
                    "description": "A visa type associated with a student, indicating immigration/residency documentation. Items unique by (visaDescriptor)."
                  },
                  "recordState": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "canonical",
                      "rejected",
                      "soft_deleted"
                    ],
                    "description": "Lifecycle state of this student record. Records are typically canonical on creation; soft_deleted when removed via DELETE."
                  },
                  "deleteSource": {
                    "type": "string",
                    "enum": [
                      "api",
                      "import",
                      "correction",
                      "retention_policy"
                    ],
                    "description": "The origin of the soft-delete action when this record is deleted."
                  }
                },
                "required": [
                  "studentSourcedId",
                  "firstName",
                  "lastSurname",
                  "birthDate"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Student"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudents",
        "summary": "List students",
        "description": "Lists student demographic records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student"
        ],
        "parameters": [
          {
            "name": "lastSurname",
            "in": "query",
            "description": "Filter by last surname.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "lastSurname",
              "operator": "eq"
            }
          },
          {
            "name": "firstName",
            "in": "query",
            "description": "Filter by first name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "firstName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only students modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Student"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/students/{id}": {
      "get": {
        "operationId": "getStudent",
        "summary": "Get a student by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Student"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudent",
        "summary": "Update a student",
        "description": "Updates a student record. Shared roster fields (firstName, lastSurname, middleName) require edfi:write-shared.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Student"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudent",
        "summary": "Soft-delete a student",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAcademicRecords": {
      "post": {
        "operationId": "createStudentAcademicRecord",
        "summary": "Create a student academic record",
        "description": "Creates a student's academic record for a specific education organization, school year, and term.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Academic Record"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentAcademicRecordRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAcademicRecord"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentAcademicRecords",
        "summary": "List student academic records",
        "description": "Lists student academic records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Academic Record"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentAcademicRecord"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAcademicRecords/{id}": {
      "get": {
        "operationId": "getStudentAcademicRecord",
        "summary": "Get a student academic record by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Academic Record"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student academic record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAcademicRecord"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_academic_record_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentAcademicRecord",
        "summary": "Update a student academic record",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Academic Record"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student academic record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentAcademicRecordRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAcademicRecord"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_academic_record_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentAcademicRecord",
        "summary": "Soft-delete a student academic record",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Academic Record"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student academic record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student academic record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_academic_record_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAssessments": {
      "post": {
        "operationId": "createStudentAssessment",
        "summary": "Create a student assessment",
        "description": "Creates a record of a student taking an assessment. The studentSourcedId must reference an existing OneRoster user.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentAssessmentRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentAssessments",
        "summary": "List student assessments",
        "description": "Lists student assessment records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessment identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "administrationDate",
            "in": "query",
            "description": "Filter by administration date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "administrationDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentAssessment"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAssessments/{id}": {
      "get": {
        "operationId": "getStudentAssessment",
        "summary": "Get a student assessment by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentAssessment",
        "summary": "Update a student assessment",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentAssessmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessment"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentAssessment",
        "summary": "Soft-delete a student assessment",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student assessment's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student assessment soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAssessmentEducationOrganizationAssociations": {
      "post": {
        "operationId": "createStudentAssessmentEducationOrganizationAssociation",
        "summary": "Create a student assessment education organization association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Education Organization Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentAssessmentEducationOrganizationAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentEducationOrganizationAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentAssessmentEducationOrganizationAssociations",
        "summary": "List student assessment education organization association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Education Organization Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessmentIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentAssessmentEducationOrganizationAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAssessmentEducationOrganizationAssociations/{id}": {
      "get": {
        "operationId": "getStudentAssessmentEducationOrganizationAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Education Organization Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentEducationOrganizationAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_education_organization_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentAssessmentEducationOrganizationAssociation",
        "summary": "Update a student assessment education organization association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Education Organization Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentAssessmentEducationOrganizationAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentEducationOrganizationAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_education_organization_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentAssessmentEducationOrganizationAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Education Organization Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_education_organization_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAssessmentRegistrations": {
      "post": {
        "operationId": "createStudentAssessmentRegistration",
        "summary": "Create a student assessment registration",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentAssessmentRegistrationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentRegistration"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentAssessmentRegistrations",
        "summary": "List student assessment registration records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "administrationIdentifier",
            "in": "query",
            "description": "Filter by administrationIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "administrationIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentAssessmentRegistration"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAssessmentRegistrations/{id}": {
      "get": {
        "operationId": "getStudentAssessmentRegistration",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentRegistration"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_registration_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentAssessmentRegistration",
        "summary": "Update a student assessment registration",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentAssessmentRegistrationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentRegistration"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_registration_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentAssessmentRegistration",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_registration_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAssessmentRegistrationBatteryPartAssociations": {
      "post": {
        "operationId": "createStudentAssessmentRegistrationBatteryPartAssociation",
        "summary": "Create a student assessment registration battery part association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration Battery Part Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentAssessmentRegistrationBatteryPartAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentRegistrationBatteryPartAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentAssessmentRegistrationBatteryPartAssociations",
        "summary": "List student assessment registration battery part association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration Battery Part Association"
        ],
        "parameters": [
          {
            "name": "assigningEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by assigningEducationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assigningEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "assessmentIdentifier",
            "in": "query",
            "description": "Filter by assessmentIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "assessmentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentAssessmentRegistrationBatteryPartAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentAssessmentRegistrationBatteryPartAssociations/{id}": {
      "get": {
        "operationId": "getStudentAssessmentRegistrationBatteryPartAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration Battery Part Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentRegistrationBatteryPartAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_registration_battery_part_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentAssessmentRegistrationBatteryPartAssociation",
        "summary": "Update a student assessment registration battery part association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration Battery Part Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentAssessmentRegistrationBatteryPartAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentAssessmentRegistrationBatteryPartAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_registration_battery_part_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentAssessmentRegistrationBatteryPartAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Assessment Registration Battery Part Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_assessment_registration_battery_part_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentCTEProgramAssociations": {
      "post": {
        "operationId": "createStudentCTEProgramAssociation",
        "summary": "Create a student CTE program association",
        "description": "Creates a student CTE program association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student CTE Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentCTEProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCTEProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentCTEProgramAssociations",
        "summary": "List student CTE program associations",
        "description": "Lists student CTE program associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student CTE Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentCTEProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentCTEProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentCTEProgramAssociation",
        "summary": "Get a student CTE program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student CTE Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCTEProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentCTEProgramAssociation",
        "summary": "Update a student CTE program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student CTE Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentCTEProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCTEProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentCTEProgramAssociation",
        "summary": "Delete a student CTE program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student CTE Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentCohortAssociations": {
      "post": {
        "operationId": "createStudentCohortAssociation",
        "summary": "Create a student cohort association",
        "description": "Creates an Ed-Fi student cohort association record linking a student to a cohort.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Cohort Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentCohortAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCohortAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentCohortAssociations",
        "summary": "List student cohort associations",
        "description": "Lists student cohort association records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Cohort Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "cohortIdentifier",
            "in": "query",
            "description": "Filter by cohort identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "cohortIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only student cohort associations modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentCohortAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentCohortAssociations/{id}": {
      "get": {
        "operationId": "getStudentCohortAssociation",
        "summary": "Get a student cohort association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Cohort Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student cohort association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCohortAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_cohort_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentCohortAssociation",
        "summary": "Update a student cohort association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Cohort Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student cohort association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentCohortAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCohortAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_cohort_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentCohortAssociation",
        "summary": "Soft-delete a student cohort association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Cohort Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student cohort association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student cohort association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_cohort_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentCompetencyObjectives": {
      "post": {
        "operationId": "createStudentCompetencyObjective",
        "summary": "Create a student competency objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Competency Objective"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentCompetencyObjectiveRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCompetencyObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentCompetencyObjectives",
        "summary": "List student competency objective records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Competency Objective"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by schoolYear.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentCompetencyObjective"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentCompetencyObjectives/{id}": {
      "get": {
        "operationId": "getStudentCompetencyObjective",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Competency Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCompetencyObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_competency_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentCompetencyObjective",
        "summary": "Update a student competency objective",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Competency Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentCompetencyObjectiveRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentCompetencyObjective"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_competency_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentCompetencyObjective",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Competency Objective"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_competency_objective_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentContactAssociations": {
      "post": {
        "operationId": "createStudentContactAssociation",
        "summary": "Create a student-contact association",
        "description": "Creates an association between a student (via roster sourcedId) and a contact.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Contact Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentContactAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentContactAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentContactAssociations",
        "summary": "List student-contact associations",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Contact Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "contactUniqueId",
            "in": "query",
            "description": "Filter by contact.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "contactUniqueId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentContactAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentContactAssociations/{id}": {
      "get": {
        "operationId": "getStudentContactAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Contact Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentContactAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_contact_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentContactAssociation",
        "summary": "Update",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Contact Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentContactAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentContactAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_contact_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentContactAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Contact Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_contact_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentDemographics": {
      "post": {
        "operationId": "createStudentDemographic",
        "summary": "Create a student demographic",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Demographic"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentDemographicRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDemographic"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentDemographics",
        "summary": "List student demographic records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Demographic"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentDemographic"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentDemographics/{id}": {
      "get": {
        "operationId": "getStudentDemographic",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Demographic"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDemographic"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_demographic_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentDemographic",
        "summary": "Update a student demographic",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Demographic"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentDemographicRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDemographic"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_demographic_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentDemographic",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Demographic"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_demographic_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentDirectories": {
      "post": {
        "operationId": "createStudentDirectory",
        "summary": "Create a student directory",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Directory"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentDirectoryRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDirectory"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentDirectories",
        "summary": "List student directory records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Directory"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentDirectory"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentDirectories/{id}": {
      "get": {
        "operationId": "getStudentDirectory",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Directory"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDirectory"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_directory_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentDirectory",
        "summary": "Update a student directory",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Directory"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentDirectoryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDirectory"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_directory_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentDirectory",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Directory"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_directory_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentDisciplineIncidentBehaviorAssociations": {
      "post": {
        "operationId": "createStudentDisciplineIncidentBehaviorAssociation",
        "summary": "Create a student discipline incident behavior association",
        "description": "Creates an association between a student and a specific behavior within a discipline incident.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Behavior Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentDisciplineIncidentBehaviorAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDisciplineIncidentBehaviorAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentDisciplineIncidentBehaviorAssociations",
        "summary": "List student discipline incident behavior associations",
        "description": "Lists student discipline incident behavior associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Behavior Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "incidentIdentifier",
            "in": "query",
            "description": "Filter by incident.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "incidentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentDisciplineIncidentBehaviorAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentDisciplineIncidentBehaviorAssociations/{id}": {
      "get": {
        "operationId": "getStudentDisciplineIncidentBehaviorAssociation",
        "summary": "Get a student discipline incident behavior association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Behavior Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDisciplineIncidentBehaviorAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_discipline_incident_behavior_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentDisciplineIncidentBehaviorAssociation",
        "summary": "Update a student discipline incident behavior association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Behavior Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentDisciplineIncidentBehaviorAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDisciplineIncidentBehaviorAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_discipline_incident_behavior_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentDisciplineIncidentBehaviorAssociation",
        "summary": "Soft-delete a student discipline incident behavior association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Behavior Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student discipline incident behavior association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_discipline_incident_behavior_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentDisciplineIncidentNonOffenderAssociations": {
      "post": {
        "operationId": "createStudentDisciplineIncidentNonOffenderAssociation",
        "summary": "Create a student discipline incident non-offender association",
        "description": "Creates an association between a non-offending student and a discipline incident.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Non-Offender Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentDisciplineIncidentNonOffenderAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDisciplineIncidentNonOffenderAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentDisciplineIncidentNonOffenderAssociations",
        "summary": "List student discipline incident non-offender associations",
        "description": "Lists student discipline incident non-offender associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Non-Offender Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "incidentIdentifier",
            "in": "query",
            "description": "Filter by incident.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "incidentIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentDisciplineIncidentNonOffenderAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentDisciplineIncidentNonOffenderAssociations/{id}": {
      "get": {
        "operationId": "getStudentDisciplineIncidentNonOffenderAssociation",
        "summary": "Get a student discipline incident non-offender association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Non-Offender Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDisciplineIncidentNonOffenderAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_discipline_incident_non_offender_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentDisciplineIncidentNonOffenderAssociation",
        "summary": "Update a student discipline incident non-offender association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Non-Offender Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentDisciplineIncidentNonOffenderAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentDisciplineIncidentNonOffenderAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_discipline_incident_non_offender_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentDisciplineIncidentNonOffenderAssociation",
        "summary": "Soft-delete a student discipline incident non-offender association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Discipline Incident Non-Offender Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student discipline incident non-offender association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_discipline_incident_non_offender_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentEducationOrganizationAssessmentAccommodations": {
      "post": {
        "operationId": "createStudentEducationOrganizationAssessmentAccommodation",
        "summary": "Create a student education organization assessment accommodation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Assessment Accommodation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentEducationOrganizationAssessmentAccommodationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationAssessmentAccommodation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentEducationOrganizationAssessmentAccommodations",
        "summary": "List student education organization assessment accommodation records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Assessment Accommodation"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentEducationOrganizationAssessmentAccommodation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentEducationOrganizationAssessmentAccommodations/{id}": {
      "get": {
        "operationId": "getStudentEducationOrganizationAssessmentAccommodation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Assessment Accommodation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationAssessmentAccommodation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_education_organization_assessment_accommodation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentEducationOrganizationAssessmentAccommodation",
        "summary": "Update a student education organization assessment accommodation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Assessment Accommodation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentEducationOrganizationAssessmentAccommodationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationAssessmentAccommodation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_education_organization_assessment_accommodation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentEducationOrganizationAssessmentAccommodation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Assessment Accommodation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_education_organization_assessment_accommodation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentEducationOrganizationAssociations": {
      "post": {
        "operationId": "createStudentEducationOrganizationAssociation",
        "summary": "Create a student education organization association",
        "description": "Creates a demographics record associating a student with an education organization. The (studentSourcedId, educationOrganizationSourcedId) tuple must be unique.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentEducationOrganizationAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentEducationOrganizationAssociations",
        "summary": "List student education organization associations",
        "description": "Lists student demographics records, optionally filtered by student or education organization.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "sexDescriptor",
            "in": "query",
            "description": "Filter by sex descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "sexDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentEducationOrganizationAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentEducationOrganizationAssociations/{id}": {
      "get": {
        "operationId": "getStudentEducationOrganizationAssociation",
        "summary": "Get a student education organization association",
        "description": "Returns one student education organization association record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentEducationOrganizationAssociation",
        "summary": "Update a student education organization association",
        "description": "Updates mutable fields of a student education organization demographics record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentEducationOrganizationAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentEducationOrganizationAssociation",
        "summary": "Delete a student education organization association",
        "description": "Soft-deletes a student education organization demographics record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentEducationOrganizationResponsibilityAssociations": {
      "post": {
        "operationId": "createStudentEducationOrganizationResponsibilityAssociation",
        "summary": "Create a student education organization responsibility association",
        "description": "Creates a responsibility record associating a student with an education organization for an effective period. The (studentSourcedId, educationOrganizationSourcedId, responsibilityDescriptor, beginDate) tuple must be unique.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Responsibility Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentEducationOrganizationResponsibilityAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationResponsibilityAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentEducationOrganizationResponsibilityAssociations",
        "summary": "List student education organization responsibility associations",
        "description": "Lists responsibility records, optionally filtered by student, education organization, or responsibility type.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Responsibility Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "responsibilityDescriptor",
            "in": "query",
            "description": "Filter by responsibility descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "responsibilityDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentEducationOrganizationResponsibilityAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentEducationOrganizationResponsibilityAssociations/{id}": {
      "get": {
        "operationId": "getStudentEducationOrganizationResponsibilityAssociation",
        "summary": "Get a student education organization responsibility association",
        "description": "Returns one responsibility record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Responsibility Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationResponsibilityAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentEducationOrganizationResponsibilityAssociation",
        "summary": "Update a student education organization responsibility association",
        "description": "Updates mutable fields of a responsibility record (e.g. setting endDate to close the period).\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Responsibility Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentEducationOrganizationResponsibilityAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentEducationOrganizationResponsibilityAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentEducationOrganizationResponsibilityAssociation",
        "summary": "Delete a student education organization responsibility association",
        "description": "Soft-deletes a responsibility record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Education Organization Responsibility Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentGradebookEntries": {
      "post": {
        "operationId": "createStudentGradebookEntry",
        "summary": "Create a student gradebook entry",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Gradebook Entry"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentGradebookEntryRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentGradebookEntry"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentGradebookEntries",
        "summary": "List student gradebook entry records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Gradebook Entry"
        ],
        "parameters": [
          {
            "name": "gradebookEntryIdentifier",
            "in": "query",
            "description": "Filter by gradebookEntryIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "gradebookEntryIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentGradebookEntry"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentGradebookEntries/{id}": {
      "get": {
        "operationId": "getStudentGradebookEntry",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Gradebook Entry"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentGradebookEntry"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_gradebook_entry_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentGradebookEntry",
        "summary": "Update a student gradebook entry",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Gradebook Entry"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentGradebookEntryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentGradebookEntry"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_gradebook_entry_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentGradebookEntry",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Gradebook Entry"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_gradebook_entry_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentHealths": {
      "post": {
        "operationId": "createStudentHealth",
        "summary": "Create a student health",
        "description": "Creates a student health record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Health"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentHealthRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentHealth"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentHealths",
        "summary": "List student healths",
        "description": "Lists student healths with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Health"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentHealth"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentHealths/{id}": {
      "get": {
        "operationId": "getStudentHealth",
        "summary": "Get a student health",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Health"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentHealth"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentHealth",
        "summary": "Update a student health",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Health"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentHealthRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentHealth"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentHealth",
        "summary": "Delete a student health",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Health"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentHomelessProgramAssociations": {
      "post": {
        "operationId": "createStudentHomelessProgramAssociation",
        "summary": "Create a student homeless program association",
        "description": "Creates a student homeless program association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Homeless Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentHomelessProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentHomelessProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentHomelessProgramAssociations",
        "summary": "List student homeless program associations",
        "description": "Lists student homeless program associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Homeless Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentHomelessProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentHomelessProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentHomelessProgramAssociation",
        "summary": "Get a student homeless program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Homeless Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentHomelessProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentHomelessProgramAssociation",
        "summary": "Update a student homeless program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Homeless Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentHomelessProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentHomelessProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentHomelessProgramAssociation",
        "summary": "Delete a student homeless program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Homeless Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIdentificationCodes": {
      "post": {
        "operationId": "createStudentIdentificationCode",
        "summary": "Create a student identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Identification Code"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentIdentificationCodes",
        "summary": "List student identification codes",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Identification Code"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentIdentificationCode"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIdentificationCodes/{id}": {
      "get": {
        "operationId": "getStudentIdentificationCode",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentIdentificationCode",
        "summary": "Update a student identification code",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentIdentificationCodeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIdentificationCode"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentIdentificationCode",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Identification Code"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_identification_code_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIEPs": {
      "post": {
        "operationId": "createStudentIep",
        "summary": "Create a student iep",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentIepRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIep"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentIeps",
        "summary": "List student iep records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "studentIepIdentifier",
            "in": "query",
            "description": "Filter by studentIepIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentIepIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentIep"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIEPs/{id}": {
      "get": {
        "operationId": "getStudentIep",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIep"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentIep",
        "summary": "Update a student iep",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentIepRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIep"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentIep",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIEPGoals": {
      "post": {
        "operationId": "createStudentIepGoal",
        "summary": "Create a student iep goal",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Goal"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentIepGoalRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepGoal"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentIepGoals",
        "summary": "List student iep goal records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Goal"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "studentIepIdentifier",
            "in": "query",
            "description": "Filter by studentIepIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentIepIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "iepGoalIdentifier",
            "in": "query",
            "description": "Filter by iepGoalIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "iepGoalIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentIepGoal"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIEPGoals/{id}": {
      "get": {
        "operationId": "getStudentIepGoal",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Goal"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepGoal"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_goal_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentIepGoal",
        "summary": "Update a student iep goal",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Goal"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentIepGoalRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepGoal"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_goal_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentIepGoal",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Goal"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_goal_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIEPServiceDeliveries": {
      "post": {
        "operationId": "createStudentIepServiceDelivery",
        "summary": "Create a student iep service delivery",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Delivery"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentIepServiceDeliveryRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepServiceDelivery"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentIepServiceDeliveries",
        "summary": "List student iep service delivery records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Delivery"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "studentIepIdentifier",
            "in": "query",
            "description": "Filter by studentIepIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentIepIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "iepServiceDeliveryIdentifier",
            "in": "query",
            "description": "Filter by iepServiceDeliveryIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "iepServiceDeliveryIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentIepServiceDelivery"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIEPServiceDeliveries/{id}": {
      "get": {
        "operationId": "getStudentIepServiceDelivery",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Delivery"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepServiceDelivery"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_service_delivery_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentIepServiceDelivery",
        "summary": "Update a student iep service delivery",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Delivery"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentIepServiceDeliveryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepServiceDelivery"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_service_delivery_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentIepServiceDelivery",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Delivery"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_service_delivery_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIEPServicePrescriptions": {
      "post": {
        "operationId": "createStudentIepServicePrescription",
        "summary": "Create a student iep service prescription",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Prescription"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentIepServicePrescriptionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepServicePrescription"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentIepServicePrescriptions",
        "summary": "List student iep service prescription records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Prescription"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "studentIepIdentifier",
            "in": "query",
            "description": "Filter by studentIepIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentIepIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "servicePrescriptionDescriptor",
            "in": "query",
            "description": "Filter by servicePrescriptionDescriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "servicePrescriptionDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentIepServicePrescription"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentIEPServicePrescriptions/{id}": {
      "get": {
        "operationId": "getStudentIepServicePrescription",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Prescription"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepServicePrescription"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_service_prescription_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentIepServicePrescription",
        "summary": "Update a student iep service prescription",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Prescription"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentIepServicePrescriptionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentIepServicePrescription"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_service_prescription_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentIepServicePrescription",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student IEP Service Prescription"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_iep_service_prescription_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentInterventionAssociations": {
      "post": {
        "operationId": "createStudentInterventionAssociation",
        "summary": "Create a student intervention association",
        "description": "Creates an Ed-Fi student intervention association record linking a student to an intervention program.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentInterventionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentInterventionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentInterventionAssociations",
        "summary": "List student intervention associations",
        "description": "Lists student intervention association records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "interventionIdentificationCode",
            "in": "query",
            "description": "Filter by intervention identification code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "interventionIdentificationCode",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only student intervention associations modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentInterventionAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentInterventionAssociations/{id}": {
      "get": {
        "operationId": "getStudentInterventionAssociation",
        "summary": "Get a student intervention association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student intervention association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentInterventionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_intervention_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentInterventionAssociation",
        "summary": "Update a student intervention association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student intervention association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentInterventionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentInterventionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_intervention_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentInterventionAssociation",
        "summary": "Soft-delete a student intervention association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student intervention association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student intervention association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_intervention_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentInterventionAttendanceEvents": {
      "post": {
        "operationId": "createStudentInterventionAttendanceEvent",
        "summary": "Create a student intervention attendance event",
        "description": "Creates an Ed-Fi student intervention attendance event record tracking attendance at an intervention session.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Attendance Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentInterventionAttendanceEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentInterventionAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentInterventionAttendanceEvents",
        "summary": "List student intervention attendance events",
        "description": "Lists student intervention attendance event records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Attendance Event"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "eventDate",
            "in": "query",
            "description": "Filter by event date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "eventDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only attendance events modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentInterventionAttendanceEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentInterventionAttendanceEvents/{id}": {
      "get": {
        "operationId": "getStudentInterventionAttendanceEvent",
        "summary": "Get a student intervention attendance event by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student intervention attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentInterventionAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_intervention_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentInterventionAttendanceEvent",
        "summary": "Update a student intervention attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student intervention attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentInterventionAttendanceEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentInterventionAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_intervention_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentInterventionAttendanceEvent",
        "summary": "Soft-delete a student intervention attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Intervention Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student intervention attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student intervention attendance event soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_intervention_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentLanguageInstructionProgramAssociations": {
      "post": {
        "operationId": "createStudentLanguageInstructionProgramAssociation",
        "summary": "Create a student language instruction program association",
        "description": "Creates a student language instruction program association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Language Instruction Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentLanguageInstructionProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentLanguageInstructionProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentLanguageInstructionProgramAssociations",
        "summary": "List student language instruction program associations",
        "description": "Lists student language instruction program associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Language Instruction Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentLanguageInstructionProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentLanguageInstructionProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentLanguageInstructionProgramAssociation",
        "summary": "Get a student language instruction program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Language Instruction Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentLanguageInstructionProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentLanguageInstructionProgramAssociation",
        "summary": "Update a student language instruction program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Language Instruction Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentLanguageInstructionProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentLanguageInstructionProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentLanguageInstructionProgramAssociation",
        "summary": "Delete a student language instruction program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Language Instruction Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentMigrantEducationProgramAssociations": {
      "post": {
        "operationId": "createStudentMigrantEducationProgramAssociation",
        "summary": "Create a student migrant education program association",
        "description": "Creates a student migrant education program association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Migrant Education Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentMigrantEducationProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentMigrantEducationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentMigrantEducationProgramAssociations",
        "summary": "List student migrant education program associations",
        "description": "Lists student migrant education program associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Migrant Education Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentMigrantEducationProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentMigrantEducationProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentMigrantEducationProgramAssociation",
        "summary": "Get a student migrant education program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Migrant Education Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentMigrantEducationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentMigrantEducationProgramAssociation",
        "summary": "Update a student migrant education program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Migrant Education Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentMigrantEducationProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentMigrantEducationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentMigrantEducationProgramAssociation",
        "summary": "Delete a student migrant education program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Migrant Education Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentNeglectedOrDelinquentProgramAssociations": {
      "post": {
        "operationId": "createStudentNeglectedOrDelinquentProgramAssociation",
        "summary": "Create a student neglected or delinquent program association",
        "description": "Creates a student neglected or delinquent program association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Neglected Or Delinquent Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentNeglectedOrDelinquentProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentNeglectedOrDelinquentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentNeglectedOrDelinquentProgramAssociations",
        "summary": "List student neglected or delinquent program associations",
        "description": "Lists student neglected or delinquent program associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Neglected Or Delinquent Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentNeglectedOrDelinquentProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentNeglectedOrDelinquentProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentNeglectedOrDelinquentProgramAssociation",
        "summary": "Get a student neglected or delinquent program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Neglected Or Delinquent Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentNeglectedOrDelinquentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentNeglectedOrDelinquentProgramAssociation",
        "summary": "Update a student neglected or delinquent program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Neglected Or Delinquent Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentNeglectedOrDelinquentProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentNeglectedOrDelinquentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentNeglectedOrDelinquentProgramAssociation",
        "summary": "Delete a student neglected or delinquent program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Neglected Or Delinquent Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentPaths": {
      "post": {
        "operationId": "createStudentPath",
        "summary": "Create a student path",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentPathRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPath"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentPaths",
        "summary": "List student path records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "pathName",
            "in": "query",
            "description": "Filter by pathName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "pathName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentPath"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentPaths/{id}": {
      "get": {
        "operationId": "getStudentPath",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPath"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentPath",
        "summary": "Update a student path",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentPathRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPath"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentPath",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentPathMilestoneStatuses": {
      "post": {
        "operationId": "createStudentPathMilestoneStatus",
        "summary": "Create a student path milestone status",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Milestone Status"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentPathMilestoneStatusRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPathMilestoneStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentPathMilestoneStatuses",
        "summary": "List student path milestone status records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Milestone Status"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "pathName",
            "in": "query",
            "description": "Filter by pathName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "pathName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentPathMilestoneStatus"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentPathMilestoneStatuses/{id}": {
      "get": {
        "operationId": "getStudentPathMilestoneStatus",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Milestone Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPathMilestoneStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_milestone_status_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentPathMilestoneStatus",
        "summary": "Update a student path milestone status",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Milestone Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentPathMilestoneStatusRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPathMilestoneStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_milestone_status_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentPathMilestoneStatus",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Milestone Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_milestone_status_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentPathPhaseStatuses": {
      "post": {
        "operationId": "createStudentPathPhaseStatus",
        "summary": "Create a student path phase status",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Phase Status"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentPathPhaseStatusRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPathPhaseStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentPathPhaseStatuses",
        "summary": "List student path phase status records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Phase Status"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by studentSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by educationOrganizationSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "pathName",
            "in": "query",
            "description": "Filter by pathName.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "pathName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentPathPhaseStatus"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentPathPhaseStatuses/{id}": {
      "get": {
        "operationId": "getStudentPathPhaseStatus",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Phase Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPathPhaseStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_phase_status_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentPathPhaseStatus",
        "summary": "Update a student path phase status",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Phase Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentPathPhaseStatusRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentPathPhaseStatus"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_phase_status_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentPathPhaseStatus",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Path Phase Status"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_path_phase_status_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentProgramAssociations": {
      "post": {
        "operationId": "createStudentProgramAssociation",
        "summary": "Create a student program association",
        "description": "Creates a generic program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentProgramAssociations",
        "summary": "List student program associations",
        "description": "Lists generic program participation records.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentProgramAssociation",
        "summary": "Get a student program association",
        "description": "Returns one program participation record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentProgramAssociation",
        "summary": "Update a student program association",
        "description": "Updates mutable fields of a program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentProgramAssociation",
        "summary": "Delete a student program association",
        "description": "Soft-deletes a program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentProgramAttendanceEvents": {
      "post": {
        "operationId": "createStudentProgramAttendanceEvent",
        "summary": "Create a student program attendance event",
        "description": "Creates a student program attendance event record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Attendance Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentProgramAttendanceEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentProgramAttendanceEvents",
        "summary": "List student program attendance events",
        "description": "Lists student program attendance events with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Attendance Event"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "eventDate",
            "in": "query",
            "description": "Filter by event date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "eventDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentProgramAttendanceEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentProgramAttendanceEvents/{id}": {
      "get": {
        "operationId": "getStudentProgramAttendanceEvent",
        "summary": "Get a student program attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentProgramAttendanceEvent",
        "summary": "Update a student program attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentProgramAttendanceEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentProgramAttendanceEvent",
        "summary": "Delete a student program attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentProgramEvaluations": {
      "post": {
        "operationId": "createStudentProgramEvaluation",
        "summary": "Create a student program evaluation",
        "description": "Creates a student program evaluation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Evaluation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentProgramEvaluationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentProgramEvaluations",
        "summary": "List student program evaluations",
        "description": "Lists student program evaluations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Evaluation"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "evaluationDate",
            "in": "query",
            "description": "Filter by evaluation date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "evaluationDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentProgramEvaluation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentProgramEvaluations/{id}": {
      "get": {
        "operationId": "getStudentProgramEvaluation",
        "summary": "Get a student program evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentProgramEvaluation",
        "summary": "Update a student program evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentProgramEvaluationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentProgramEvaluation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentProgramEvaluation",
        "summary": "Delete a student program evaluation",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Program Evaluation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSchoolAssociations": {
      "post": {
        "operationId": "createStudentSchoolAssociation",
        "summary": "Create a student school association",
        "description": "Creates an enrollment record associating a student with a school for an effective period. The (studentSourcedId, schoolSourcedId, entryDate) tuple must be unique; overlapping periods for the same subject are rejected.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentSchoolAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentSchoolAssociations",
        "summary": "List student school associations",
        "description": "Lists enrollment records, optionally filtered by student, school, grade level, or effective date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "entryDate",
            "in": "query",
            "description": "Filter by exact entry date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "entryDate",
              "operator": "eq"
            }
          },
          {
            "name": "entryGradeLevelDescriptor",
            "in": "query",
            "description": "Filter by entry grade level.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "entryGradeLevelDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "schoolYear",
            "in": "query",
            "description": "Filter by school year.",
            "schema": {
              "type": "integer"
            },
            "x-filter": {
              "column": "schoolYear",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentSchoolAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSchoolAssociations/{id}": {
      "get": {
        "operationId": "getStudentSchoolAssociation",
        "summary": "Get a student school association",
        "description": "Returns one enrollment record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentSchoolAssociation",
        "summary": "Update a student school association",
        "description": "Updates mutable fields of an enrollment record (e.g. setting exitWithdrawDate to close the period).\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentSchoolAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentSchoolAssociation",
        "summary": "Delete a student school association",
        "description": "Soft-deletes an enrollment record. The effective period stops counting against the non-overlap constraint.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSchoolAttendanceEvents": {
      "post": {
        "operationId": "createStudentSchoolAttendanceEvent",
        "summary": "Create a student school attendance event",
        "description": "Creates a school-level attendance event record for a student.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Attendance Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentSchoolAttendanceEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentSchoolAttendanceEvents",
        "summary": "List student school attendance events",
        "description": "Lists school-level attendance event records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Attendance Event"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "eventDate",
            "in": "query",
            "description": "Filter by event date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "eventDate",
              "operator": "eq"
            }
          },
          {
            "name": "attendanceEventCategoryDescriptor",
            "in": "query",
            "description": "Filter by attendance event category.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "attendanceEventCategoryDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentSchoolAttendanceEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSchoolAttendanceEvents/{id}": {
      "get": {
        "operationId": "getStudentSchoolAttendanceEvent",
        "summary": "Get a student school attendance event by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_school_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentSchoolAttendanceEvent",
        "summary": "Update a student school attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentSchoolAttendanceEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_school_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentSchoolAttendanceEvent",
        "summary": "Soft-delete a student school attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student school attendance event soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_school_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSchoolFoodServiceProgramAssociations": {
      "post": {
        "operationId": "createStudentSchoolFoodServiceProgramAssociation",
        "summary": "Create a student food service program association",
        "description": "Creates an association between a student and a food service program.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Food Service Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentSchoolFoodServiceProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolFoodServiceProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentSchoolFoodServiceProgramAssociations",
        "summary": "List student food service program associations",
        "description": "Lists student food service program association records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Food Service Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "programName",
            "in": "query",
            "description": "Filter by program name.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programName",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentSchoolFoodServiceProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSchoolFoodServiceProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentSchoolFoodServiceProgramAssociation",
        "summary": "Get a student food service program association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Food Service Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolFoodServiceProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_school_food_service_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentSchoolFoodServiceProgramAssociation",
        "summary": "Update a student food service program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Food Service Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentSchoolFoodServiceProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSchoolFoodServiceProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_school_food_service_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentSchoolFoodServiceProgramAssociation",
        "summary": "Soft-delete a student food service program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student School Food Service Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student food service program association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_school_food_service_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSection504ProgramAssociations": {
      "post": {
        "operationId": "createStudentSection504ProgramAssociation",
        "summary": "Create a student Section 504 program association",
        "description": "Creates a student Section 504 program association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section 504 Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentSection504ProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSection504ProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentSection504ProgramAssociations",
        "summary": "List student Section 504 program associations",
        "description": "Lists student Section 504 program associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section 504 Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentSection504ProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSection504ProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentSection504ProgramAssociation",
        "summary": "Get a student Section 504 program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section 504 Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSection504ProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentSection504ProgramAssociation",
        "summary": "Update a student Section 504 program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section 504 Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentSection504ProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSection504ProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentSection504ProgramAssociation",
        "summary": "Delete a student Section 504 program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section 504 Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSectionAssociations": {
      "post": {
        "operationId": "createStudentSectionAssociation",
        "summary": "Create a student section association",
        "description": "Assigns a student to a course section beginning on the specified date.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentSectionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentSectionAssociations",
        "summary": "List student section associations",
        "description": "Returns student-to-section assignment records matching the given filters.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "classSourcedId",
            "in": "query",
            "description": "Filter by class (section) sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "classSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "beginDate",
            "in": "query",
            "description": "Filter by exact begin date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "beginDate",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentSectionAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSectionAssociations/{id}": {
      "get": {
        "operationId": "getStudentSectionAssociation",
        "summary": "Get a student section association",
        "description": "Returns one student section assignment record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentSectionAssociation",
        "summary": "Update a student section association",
        "description": "Updates mutable fields of a student section assignment record (e.g. setting endDate).\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentSectionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentSectionAssociation",
        "summary": "Delete a student section association",
        "description": "Soft-deletes a student section assignment record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSectionAttendanceEvents": {
      "post": {
        "operationId": "createStudentSectionAttendanceEvent",
        "summary": "Create a student section attendance event",
        "description": "Creates a section-level attendance event record for a student. This entity is the base for the Alpha attendanceEvent projection.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Attendance Event"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentSectionAttendanceEventRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSectionAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentSectionAttendanceEvents",
        "summary": "List student section attendance events",
        "description": "Lists section-level attendance event records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Attendance Event"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "classSourcedId",
            "in": "query",
            "description": "Filter by class sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "classSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "eventDate",
            "in": "query",
            "description": "Filter by event date.",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "x-filter": {
              "column": "eventDate",
              "operator": "eq"
            }
          },
          {
            "name": "attendanceEventCategoryDescriptor",
            "in": "query",
            "description": "Filter by attendance event category.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "attendanceEventCategoryDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentSectionAttendanceEvent"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSectionAttendanceEvents/{id}": {
      "get": {
        "operationId": "getStudentSectionAttendanceEvent",
        "summary": "Get a student section attendance event by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSectionAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_section_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentSectionAttendanceEvent",
        "summary": "Update a student section attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentSectionAttendanceEventRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSectionAttendanceEvent"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_section_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentSectionAttendanceEvent",
        "summary": "Soft-delete a student section attendance event",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Section Attendance Event"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The attendance event's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student section attendance event soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_section_attendance_event_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSpecialEducationProgramAssociations": {
      "post": {
        "operationId": "createStudentSpecialEducationProgramAssociation",
        "summary": "Create a student special education program association",
        "description": "Creates a special education program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentSpecialEducationProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSpecialEducationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentSpecialEducationProgramAssociations",
        "summary": "List student special education program associations",
        "description": "Lists special education program participation records.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentSpecialEducationProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSpecialEducationProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentSpecialEducationProgramAssociation",
        "summary": "Get a student special education program association",
        "description": "Returns one special education program participation record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSpecialEducationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentSpecialEducationProgramAssociation",
        "summary": "Update a student special education program association",
        "description": "Updates mutable fields of a special education program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentSpecialEducationProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSpecialEducationProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentSpecialEducationProgramAssociation",
        "summary": "Delete a student special education program association",
        "description": "Soft-deletes a special education program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSpecialEducationProgramEligibilityAssociations": {
      "post": {
        "operationId": "createStudentSpecialEducationProgramEligibilityAssociation",
        "summary": "Create a student special education program eligibility association",
        "description": "Creates a student special education program eligibility association record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Eligibility Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentSpecialEducationProgramEligibilityAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSpecialEducationProgramEligibilityAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentSpecialEducationProgramEligibilityAssociations",
        "summary": "List student special education program eligibility associations",
        "description": "Lists student special education program eligibility associations with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Eligibility Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by evaluating education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentSpecialEducationProgramEligibilityAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentSpecialEducationProgramEligibilityAssociations/{id}": {
      "get": {
        "operationId": "getStudentSpecialEducationProgramEligibilityAssociation",
        "summary": "Get a student special education program eligibility association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Eligibility Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSpecialEducationProgramEligibilityAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentSpecialEducationProgramEligibilityAssociation",
        "summary": "Update a student special education program eligibility association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Eligibility Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentSpecialEducationProgramEligibilityAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentSpecialEducationProgramEligibilityAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentSpecialEducationProgramEligibilityAssociation",
        "summary": "Delete a student special education program eligibility association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Special Education Program Eligibility Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentTitleIPartAProgramAssociations": {
      "post": {
        "operationId": "createStudentTitleIPartAProgramAssociation",
        "summary": "Create a student Title I Part A program association",
        "description": "Creates a Title I Part A program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Title I Part A Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentTitleIPartAProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentTitleIPartAProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentTitleIPartAProgramAssociations",
        "summary": "List student Title I Part A program associations",
        "description": "Lists Title I Part A program participation records.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Title I Part A Program Association"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "programEducationOrganizationSourcedId",
            "in": "query",
            "description": "Filter by program education organization sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "programEducationOrganizationSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "titleIPartAParticipantDescriptor",
            "in": "query",
            "description": "Filter by Title I Part A participant descriptor.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "titleIPartAParticipantDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentTitleIPartAProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentTitleIPartAProgramAssociations/{id}": {
      "get": {
        "operationId": "getStudentTitleIPartAProgramAssociation",
        "summary": "Get a student Title I Part A program association",
        "description": "Returns one Title I Part A program participation record by its derived GUID.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Title I Part A Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentTitleIPartAProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentTitleIPartAProgramAssociation",
        "summary": "Update a student Title I Part A program association",
        "description": "Updates mutable fields of a Title I Part A program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Title I Part A Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentTitleIPartAProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentTitleIPartAProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentTitleIPartAProgramAssociation",
        "summary": "Delete a student Title I Part A program association",
        "description": "Soft-deletes a Title I Part A program participation record.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Title I Part A Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The record's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentTransportations": {
      "post": {
        "operationId": "createStudentTransportation",
        "summary": "Create a student transportation record",
        "description": "Creates a transportation record for a student at a school.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Transportation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStudentTransportationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentTransportation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listStudentTransportations",
        "summary": "List student transportation records",
        "description": "Lists student transportation records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Transportation"
        ],
        "parameters": [
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "schoolSourcedId",
            "in": "query",
            "description": "Filter by school sourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "schoolSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StudentTransportation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/studentTransportations/{id}": {
      "get": {
        "operationId": "getStudentTransportation",
        "summary": "Get a student transportation record by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Transportation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student transportation's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentTransportation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_transportation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateStudentTransportation",
        "summary": "Update a student transportation record",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Transportation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student transportation's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStudentTransportationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StudentTransportation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_transportation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteStudentTransportation",
        "summary": "Soft-delete a student transportation record",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Student Transportation"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The student transportation's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Student transportation record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (student_transportation_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveys": {
      "post": {
        "operationId": "createSurvey",
        "summary": "Create a survey",
        "description": "Creates an Ed-Fi survey record with metadata including title, category, and administration counts.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Survey"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveys",
        "summary": "List surveys",
        "description": "Lists survey records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by survey identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyCategoryDescriptor",
            "in": "query",
            "description": "Filter by survey category.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyCategoryDescriptor",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only surveys modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Survey"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveys/{id}": {
      "get": {
        "operationId": "getSurvey",
        "summary": "Get a survey by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Survey"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurvey",
        "summary": "Update a survey",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Survey"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurvey",
        "summary": "Soft-delete a survey",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Survey soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyCourseAssociations": {
      "post": {
        "operationId": "createSurveyCourseAssociation",
        "summary": "Create a survey course association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Course Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyCourseAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyCourseAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveyCourseAssociations",
        "summary": "List survey course association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Course Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by surveyIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by educationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveyCourseAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyCourseAssociations/{id}": {
      "get": {
        "operationId": "getSurveyCourseAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Course Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyCourseAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_course_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveyCourseAssociation",
        "summary": "Update a survey course association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Course Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyCourseAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyCourseAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_course_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveyCourseAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Course Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_course_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyProgramAssociations": {
      "post": {
        "operationId": "createSurveyProgramAssociation",
        "summary": "Create a survey program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Program Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveyProgramAssociations",
        "summary": "List survey program association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Program Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by surveyIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by educationOrganizationId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveyProgramAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyProgramAssociations/{id}": {
      "get": {
        "operationId": "getSurveyProgramAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveyProgramAssociation",
        "summary": "Update a survey program association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyProgramAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyProgramAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveyProgramAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Program Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_program_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyQuestions": {
      "post": {
        "operationId": "createSurveyQuestion",
        "summary": "Create a survey question",
        "description": "Creates a survey question record with text, form type, and optional section assignment.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyQuestionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyQuestion"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveyQuestions",
        "summary": "List survey questions",
        "description": "Lists survey question records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by survey identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveySectionTitle",
            "in": "query",
            "description": "Filter by survey section title.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveySectionTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveyQuestion"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyQuestions/{id}": {
      "get": {
        "operationId": "getSurveyQuestion",
        "summary": "Get a survey question by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey question's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyQuestion"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_question_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveyQuestion",
        "summary": "Update a survey question",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey question's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyQuestionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyQuestion"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_question_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveyQuestion",
        "summary": "Soft-delete a survey question",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey question's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Survey question soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_question_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyQuestionResponses": {
      "post": {
        "operationId": "createSurveyQuestionResponse",
        "summary": "Create a survey question response",
        "description": "Creates a survey question response record capturing the respondent's answer to a specific question.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question Response"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyQuestionResponseRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyQuestionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveyQuestionResponses",
        "summary": "List survey question responses",
        "description": "Lists survey question response records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question Response"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by survey identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyResponseIdentifier",
            "in": "query",
            "description": "Filter by survey response identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyResponseIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "questionCode",
            "in": "query",
            "description": "Filter by question code.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "questionCode",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveyQuestionResponse"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyQuestionResponses/{id}": {
      "get": {
        "operationId": "getSurveyQuestionResponse",
        "summary": "Get a survey question response by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey question response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyQuestionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_question_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveyQuestionResponse",
        "summary": "Update a survey question response",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey question response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyQuestionResponseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyQuestionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_question_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveyQuestionResponse",
        "summary": "Soft-delete a survey question response",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Question Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey question response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Survey question response soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_question_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyResponses": {
      "post": {
        "operationId": "createSurveyResponse",
        "summary": "Create a survey response",
        "description": "Creates a survey response record. The studentSourcedId or staffSourcedId, if provided, must reference an existing OneRoster user.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyResponseRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveyResponses",
        "summary": "List survey responses",
        "description": "Lists survey response records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by survey identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "studentSourcedId",
            "in": "query",
            "description": "Filter by student.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "studentSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "staffSourcedId",
            "in": "query",
            "description": "Filter by staff member.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "staffSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveyResponse"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyResponses/{id}": {
      "get": {
        "operationId": "getSurveyResponse",
        "summary": "Get a survey response by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveyResponse",
        "summary": "Update a survey response",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyResponseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveyResponse",
        "summary": "Soft-delete a survey response",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Survey response soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyResponseEducationOrganizationTargetAssociations": {
      "post": {
        "operationId": "createSurveyResponseEducationOrganizationTargetAssociation",
        "summary": "Create a survey response education organization target association",
        "description": "Creates an association linking a survey response to a target education organization.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Education Organization Target Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyResponseEducationOrganizationTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponseEducationOrganizationTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveyResponseEducationOrganizationTargetAssociations",
        "summary": "List survey response education organization target associations",
        "description": "Lists association records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Education Organization Target Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by survey identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyResponseIdentifier",
            "in": "query",
            "description": "Filter by survey response identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyResponseIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveyResponseEducationOrganizationTargetAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyResponseEducationOrganizationTargetAssociations/{id}": {
      "get": {
        "operationId": "getSurveyResponseEducationOrganizationTargetAssociation",
        "summary": "Get an association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Education Organization Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponseEducationOrganizationTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_education_organization_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveyResponseEducationOrganizationTargetAssociation",
        "summary": "Update an association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Education Organization Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyResponseEducationOrganizationTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponseEducationOrganizationTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_education_organization_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveyResponseEducationOrganizationTargetAssociation",
        "summary": "Soft-delete an association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Education Organization Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_education_organization_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyResponsePersonTargetAssociations": {
      "post": {
        "operationId": "createSurveyResponsePersonTargetAssociation",
        "summary": "Create a survey response person target association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Person Target Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyResponsePersonTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponsePersonTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveyResponsePersonTargetAssociations",
        "summary": "List survey response person target association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Person Target Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by surveyIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyResponseIdentifier",
            "in": "query",
            "description": "Filter by surveyResponseIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyResponseIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveyResponsePersonTargetAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyResponsePersonTargetAssociations/{id}": {
      "get": {
        "operationId": "getSurveyResponsePersonTargetAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Person Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponsePersonTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_person_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveyResponsePersonTargetAssociation",
        "summary": "Update a survey response person target association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Person Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyResponsePersonTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponsePersonTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_person_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveyResponsePersonTargetAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Person Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_person_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyResponseStaffTargetAssociations": {
      "post": {
        "operationId": "createSurveyResponseStaffTargetAssociation",
        "summary": "Create a survey response staff target association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Staff Target Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveyResponseStaffTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponseStaffTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveyResponseStaffTargetAssociations",
        "summary": "List survey response staff target association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Staff Target Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by surveyIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyResponseIdentifier",
            "in": "query",
            "description": "Filter by surveyResponseIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyResponseIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveyResponseStaffTargetAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveyResponseStaffTargetAssociations/{id}": {
      "get": {
        "operationId": "getSurveyResponseStaffTargetAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Staff Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponseStaffTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_staff_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveyResponseStaffTargetAssociation",
        "summary": "Update a survey response staff target association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Staff Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveyResponseStaffTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveyResponseStaffTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_staff_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveyResponseStaffTargetAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Response Staff Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_response_staff_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySections": {
      "post": {
        "operationId": "createSurveySection",
        "summary": "Create a survey section",
        "description": "Creates a survey section record representing a logical grouping of questions within a survey.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveySectionRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySection"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveySections",
        "summary": "List survey sections",
        "description": "Lists survey section records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by survey identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveySection"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySections/{id}": {
      "get": {
        "operationId": "getSurveySection",
        "summary": "Get a survey section by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey section's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySection"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveySection",
        "summary": "Update a survey section",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey section's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveySectionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySection"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveySection",
        "summary": "Soft-delete a survey section",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey section's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Survey section soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionAggregateResponses": {
      "post": {
        "operationId": "createSurveySectionAggregateResponse",
        "summary": "Create a survey section aggregate response",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Aggregate Response"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveySectionAggregateResponseRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionAggregateResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveySectionAggregateResponses",
        "summary": "List survey section aggregate response records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Aggregate Response"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "query",
            "description": "Filter by personId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "personId",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by surveyIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveySectionTitle",
            "in": "query",
            "description": "Filter by surveySectionTitle.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveySectionTitle",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveySectionAggregateResponse"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionAggregateResponses/{id}": {
      "get": {
        "operationId": "getSurveySectionAggregateResponse",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Aggregate Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionAggregateResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_aggregate_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveySectionAggregateResponse",
        "summary": "Update a survey section aggregate response",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Aggregate Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveySectionAggregateResponseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionAggregateResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_aggregate_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveySectionAggregateResponse",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Aggregate Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_aggregate_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionAssociations": {
      "post": {
        "operationId": "createSurveySectionAssociation",
        "summary": "Create a survey section association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveySectionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveySectionAssociations",
        "summary": "List survey section association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by surveyIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "classSourcedId",
            "in": "query",
            "description": "Filter by classSourcedId.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "classSourcedId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveySectionAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionAssociations/{id}": {
      "get": {
        "operationId": "getSurveySectionAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveySectionAssociation",
        "summary": "Update a survey section association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveySectionAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveySectionAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionResponses": {
      "post": {
        "operationId": "createSurveySectionResponse",
        "summary": "Create a survey section response",
        "description": "Creates a survey section response record linking a response to a specific section with an optional rating.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveySectionResponseRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveySectionResponses",
        "summary": "List survey section responses",
        "description": "Lists survey section response records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by survey identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyResponseIdentifier",
            "in": "query",
            "description": "Filter by survey response identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyResponseIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveySectionResponse"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionResponses/{id}": {
      "get": {
        "operationId": "getSurveySectionResponse",
        "summary": "Get a survey section response by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey section response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveySectionResponse",
        "summary": "Update a survey section response",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey section response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveySectionResponseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveySectionResponse",
        "summary": "Soft-delete a survey section response",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The survey section response's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Survey section response soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionResponseEducationOrganizationTargetAssociations": {
      "post": {
        "operationId": "createSurveySectionResponseEducationOrganizationTargetAssociation",
        "summary": "Create a survey section response education organization target association",
        "description": "Creates an association linking a survey section response to a target education organization.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Education Organization Target Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveySectionResponseEducationOrganizationTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponseEducationOrganizationTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveySectionResponseEducationOrganizationTargetAssociations",
        "summary": "List survey section response education organization target associations",
        "description": "Lists association records with optional filtering.\n\n> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Education Organization Target Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by survey identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyResponseIdentifier",
            "in": "query",
            "description": "Filter by survey response identifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyResponseIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveySectionTitle",
            "in": "query",
            "description": "Filter by survey section title.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveySectionTitle",
              "operator": "eq"
            }
          },
          {
            "name": "educationOrganizationId",
            "in": "query",
            "description": "Filter by education organization.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "educationOrganizationId",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 25, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveySectionResponseEducationOrganizationTargetAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionResponseEducationOrganizationTargetAssociations/{id}": {
      "get": {
        "operationId": "getSurveySectionResponseEducationOrganizationTargetAssociation",
        "summary": "Get an association by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Education Organization Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponseEducationOrganizationTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_education_organization_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveySectionResponseEducationOrganizationTargetAssociation",
        "summary": "Update an association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Education Organization Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveySectionResponseEducationOrganizationTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponseEducationOrganizationTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_education_organization_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveySectionResponseEducationOrganizationTargetAssociation",
        "summary": "Soft-delete an association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Education Organization Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The association's derived GUID.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Association soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_education_organization_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionResponsePersonTargetAssociations": {
      "post": {
        "operationId": "createSurveySectionResponsePersonTargetAssociation",
        "summary": "Create a survey section response person target association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Person Target Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveySectionResponsePersonTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponsePersonTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveySectionResponsePersonTargetAssociations",
        "summary": "List survey section response person target association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Person Target Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by surveyIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyResponseIdentifier",
            "in": "query",
            "description": "Filter by surveyResponseIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyResponseIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveySectionResponsePersonTargetAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionResponsePersonTargetAssociations/{id}": {
      "get": {
        "operationId": "getSurveySectionResponsePersonTargetAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Person Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponsePersonTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_person_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveySectionResponsePersonTargetAssociation",
        "summary": "Update a survey section response person target association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Person Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveySectionResponsePersonTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponsePersonTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_person_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveySectionResponsePersonTargetAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Person Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_person_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionResponseStaffTargetAssociations": {
      "post": {
        "operationId": "createSurveySectionResponseStaffTargetAssociation",
        "summary": "Create a survey section response staff target association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Staff Target Association"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSurveySectionResponseStaffTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponseStaffTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "get": {
        "operationId": "listSurveySectionResponseStaffTargetAssociations",
        "summary": "List survey section response staff target association records",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Staff Target Association"
        ],
        "parameters": [
          {
            "name": "namespace",
            "in": "query",
            "description": "Filter by namespace.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "namespace",
              "operator": "eq"
            }
          },
          {
            "name": "surveyIdentifier",
            "in": "query",
            "description": "Filter by surveyIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "surveyResponseIdentifier",
            "in": "query",
            "description": "Filter by surveyResponseIdentifier.",
            "schema": {
              "type": "string"
            },
            "x-filter": {
              "column": "surveyResponseIdentifier",
              "operator": "eq"
            }
          },
          {
            "name": "modifiedSince",
            "in": "query",
            "description": "Return only records modified at or after this instant.",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "x-filter": {
              "column": "updatedAt",
              "operator": "gte"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return on this page (default 100, clamped server-side).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Zero-based index of the first item to return (default 0). Ignored when `cursor` is set.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from the previous page's X-Next-Cursor header. Prefer over deep `offset` when present.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SurveySectionResponseStaffTargetAssociation"
                  }
                }
              }
            },
            "headers": {
              "X-Total-Count": {
                "description": "The total number of rows matching the request (across all pages). Always present on offset-mode list responses.",
                "schema": {
                  "type": "integer",
                  "minimum": 0
                }
              },
              "X-Next-Cursor": {
                "description": "Opaque keyset cursor for the next page (echo as ?cursor=). Present when more rows exist and the order is key-suffixed.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not Found.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/ed-fi/surveySectionResponseStaffTargetAssociations/{id}": {
      "get": {
        "operationId": "getSurveySectionResponseStaffTargetAssociation",
        "summary": "Get by GUID",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Staff Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponseStaffTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_staff_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateSurveySectionResponseStaffTargetAssociation",
        "summary": "Update a survey section response staff target association",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Staff Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSurveySectionResponseStaffTargetAssociationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SurveySectionResponseStaffTargetAssociation"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_staff_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteSurveySectionResponseStaffTargetAssociation",
        "summary": "Soft-delete",
        "description": "> **Auth required:** a verified bearer token is required.",
        "tags": [
          "Survey Section Response Staff Target Association"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "204": {
            "description": "No Content.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Record soft-deleted."
                }
              }
            }
          },
          "400": {
            "description": "Bad Request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Problem (survey_section_response_staff_target_association_not_found).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "409": {
            "description": "Conflict.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AcademicWeek": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, weekIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school this academic week belongs to.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "weekIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "The school label for the week."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The start date for the academic week."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date for the academic week."
          },
          "totalInstructionalDays": {
            "type": "integer",
            "description": "The total instructional days during the academic week."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "weekIdentifier",
          "beginDate",
          "endDate",
          "totalInstructionalDays",
          "recordState",
          "updatedAt"
        ]
      },
      "AccountabilityRating": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, ratingTitle, schoolYear).",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization the accountability rating relates to.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "ratingTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The title of the rating."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year for which the accountability rating is assessed."
          },
          "rating": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "An accountability rating level, designation, or assessment."
          },
          "ratingDate": {
            "type": "string",
            "format": "date",
            "description": "The date the rating was awarded."
          },
          "ratingOrganization": {
            "type": "string",
            "maxLength": 35,
            "description": "The organization that assessed the rating."
          },
          "ratingProgram": {
            "type": "string",
            "maxLength": 30,
            "description": "The program associated with the accountability rating (e.g., NCLB, AEIS)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "ratingTitle",
          "schoolYear",
          "rating",
          "recordState",
          "updatedAt"
        ]
      },
      "ApplicantProfile": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, applicantProfileIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Identifier assigned to a person making formal application."
          },
          "name": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal first name."
              },
              "lastSurname": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal last/surname."
              },
              "middleName": {
                "type": "string",
                "maxLength": 75,
                "description": "Middle name."
              },
              "personalTitlePrefix": {
                "type": "string",
                "maxLength": 30,
                "description": "Title prefix (e.g., Mr., Dr.)."
              },
              "generationCodeSuffix": {
                "type": "string",
                "maxLength": 10,
                "description": "Generation suffix (e.g., Jr., III)."
              },
              "maidenName": {
                "type": "string",
                "maxLength": 75,
                "description": "Maiden name."
              },
              "preferredFirstName": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred first name."
              },
              "preferredLastSurname": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred last/surname."
              }
            },
            "required": [
              "firstName",
              "lastSurname"
            ],
            "description": "Full legal name of the person."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Sex."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "Gender identity."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Birth date."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Street number and name."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "Apartment/room/suite."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Building/site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "City."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "State abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "Postal code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "County name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Locale."
                },
                "periods": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "beginDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Period begin date."
                      },
                      "endDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Period end date."
                      }
                    },
                    "required": [
                      "beginDate"
                    ],
                    "description": "periodsItem value."
                  },
                  "description": "Effective date periods."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses associated with the person."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Email address."
                },
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Email type."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "electronicMailAddress",
                "electronicMailTypeDescriptor"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race designations."
          },
          "citizenship": {
            "type": "object",
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages."
          },
          "backgroundChecks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "backgroundCheckTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Background check type."
                },
                "backgroundCheckRequestedDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date requested."
                },
                "backgroundCheckStatusDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Background check status."
                },
                "backgroundCheckCompletedDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date completed."
                },
                "fingerprint": {
                  "type": "boolean",
                  "description": "Fingerprint indicator."
                }
              },
              "required": [
                "backgroundCheckTypeDescriptor",
                "backgroundCheckRequestedDate"
              ],
              "description": "backgroundChecksItem value."
            },
            "description": "Background checks."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "economicDisadvantageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Economic disadvantage."
          },
          "firstGenerationStudent": {
            "type": "boolean",
            "description": "First-generation student indicator."
          },
          "applicantCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Applicant/student characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ],
              "description": "applicantCharacteristicsItem value."
            },
            "description": "Applicant characteristics (folded)."
          },
          "highestCompletedLevelOfEducationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Highest completed level of education."
          },
          "yearsOfPriorProfessionalExperience": {
            "type": "number",
            "description": "Years of prior professional experience."
          },
          "yearsOfPriorTeachingExperience": {
            "type": "number",
            "description": "Years of prior teaching experience."
          },
          "highlyQualifiedTeacher": {
            "type": "boolean",
            "description": "Highly qualified teacher indicator."
          },
          "highlyQualifiedAcademicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Academic subject."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ],
              "description": "highlyQualifiedAcademicSubjectsItem value."
            },
            "description": "Highly qualified academic subjects."
          },
          "gradePointAverages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradePointAverageTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "GPA type."
                },
                "isCumulative": {
                  "type": "boolean",
                  "description": "Cumulative indicator."
                },
                "gradePointAverageValue": {
                  "type": "number",
                  "description": "GPA value."
                },
                "maxGradePointAverageValue": {
                  "type": "number",
                  "description": "Max GPA value."
                }
              },
              "required": [
                "gradePointAverageTypeDescriptor",
                "gradePointAverageValue"
              ],
              "description": "gradePointAveragesItem value."
            },
            "description": "Grade point averages (folded)."
          },
          "educatorPreparationProgramNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educatorPreparationProgramName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Educator preparation program name."
                }
              },
              "required": [
                "educatorPreparationProgramName"
              ],
              "description": "educatorPreparationProgramNamesItem value."
            },
            "description": "Educator preparation program names."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "applicantProfileIdentifier",
          "name",
          "recordState",
          "updatedAt"
        ]
      },
      "Application": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, applicationIdentifier, educationOrganizationSourcedId, applicantProfileIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "applicationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Identifier assigned to the application."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization receiving the application. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The applicant profile submitting the application.",
            "x-references": "applicantProfile.applicantProfileIdentifier",
            "x-onDelete": "restrict"
          },
          "applicationDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the application."
          },
          "applicationStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Application status."
          },
          "currentEmployee": {
            "type": "boolean",
            "description": "Whether the applicant is a current employee."
          },
          "academicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Academic subject."
          },
          "acceptedDate": {
            "type": "string",
            "format": "date",
            "description": "Date accepted."
          },
          "applicationSourceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Application source."
          },
          "firstContactDate": {
            "type": "string",
            "format": "date",
            "description": "First contact date."
          },
          "highNeedsAcademicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "High-needs academic subject."
          },
          "hireStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Hire status."
          },
          "hiringSourceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Hiring source."
          },
          "withdrawDate": {
            "type": "string",
            "format": "date",
            "description": "Withdraw date."
          },
          "withdrawReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Withdraw reason."
          },
          "terms": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term."
                }
              },
              "required": [
                "termDescriptor"
              ],
              "description": "termsItem value."
            },
            "description": "Terms associated with the application."
          },
          "scoreResults": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "result": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 35,
                  "description": "Result value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Result datatype."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Assessment reporting method."
                }
              },
              "required": [
                "result",
                "resultDatatypeTypeDescriptor",
                "assessmentReportingMethodDescriptor"
              ],
              "description": "scoreResultsItem value."
            },
            "description": "Score results (folded)."
          },
          "openStaffPositionEducationOrganizationId": {
            "type": "string",
            "maxLength": 60,
            "description": "Education organization of the optional open staff position.",
            "x-references": "openStaffPosition.educationOrganizationId",
            "x-references-legs": [
              "requisitionNumber"
            ],
            "x-onDelete": "restrict"
          },
          "requisitionNumber": {
            "type": "string",
            "maxLength": 20,
            "description": "Requisition number of the optional open staff position."
          },
          "recruitmentEventAttendances": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "recruitmentEventAttendeeIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 32,
                  "description": "Attendee identifier."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Recruitment event education organization."
                },
                "eventTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Recruitment event title."
                },
                "eventDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Recruitment event date."
                }
              },
              "required": [
                "recruitmentEventAttendeeIdentifier",
                "educationOrganizationSourcedId",
                "eventTitle",
                "eventDate"
              ],
              "description": "recruitmentEventAttendancesItem value."
            },
            "description": "Linked recruitment event attendances (folded reference collection)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "applicationIdentifier",
          "educationOrganizationSourcedId",
          "applicantProfileIdentifier",
          "applicationDate",
          "applicationStatusDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "ApplicationEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, applicationIdentifier, educationOrganizationSourcedId, applicantProfileIdentifier, eventDate, sequenceNumber, applicationEventTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "applicationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Parent application identifier.",
            "x-references": "application.applicationIdentifier",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "applicantProfileIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent application."
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Applicant profile of the parent application."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the application event."
          },
          "eventEndDate": {
            "type": "string",
            "format": "date",
            "description": "End date of the application event."
          },
          "sequenceNumber": {
            "type": "integer",
            "description": "Sequence number of the event."
          },
          "applicationEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Application event type."
          },
          "applicationEvaluationScore": {
            "type": "number",
            "description": "Evaluation score."
          },
          "applicationEventResultDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Application event result."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year associated with the event."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Term."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "applicationIdentifier",
          "educationOrganizationSourcedId",
          "applicantProfileIdentifier",
          "eventDate",
          "sequenceNumber",
          "applicationEventTypeDescriptor",
          "schoolYear",
          "recordState",
          "updatedAt"
        ]
      },
      "Assessment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assessmentIdentifier, namespace). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an assessment by a school, school system, a state, or other agency or entity."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the assessment, typically a URI like uri://ed-fi.org/Assessment/..."
          },
          "assessmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The title or name of the assessment."
          },
          "assessmentCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of an assessment based on format and content."
          },
          "assessmentForm": {
            "type": "string",
            "maxLength": 60,
            "description": "Identifies the form of the assessment, for example a regular versus makeup form."
          },
          "assessmentVersion": {
            "type": "integer",
            "description": "The version identifier for the assessment."
          },
          "revisionDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year that the conceptual design for the assessment was most recently revised substantially."
          },
          "maxRawScore": {
            "type": "number",
            "description": "The maximum raw score achievable across all assessment items that are correct and scored at the maximum."
          },
          "nomenclature": {
            "type": "string",
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used for assessment."
          },
          "adaptiveAssessment": {
            "type": "boolean",
            "description": "Indicates that the assessment is adaptive."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject associated with the assessment (e.g., Mathematics, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject tested by an assessment. Collection child of Assessment, allowing multiple subjects per assessment. Items unique by (academicSubjectDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The system that assigned the identification code (e.g., State, Federal, Test Contractor)."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to the assessment by the identification system."
                },
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The organization code or name assigning the assessment identification code."
                }
              },
              "required": [
                "assessmentIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an assessment by a governing body (e.g., state assessment ID, federal ID). Collection child of Assessment. Items unique by (assessmentIdentificationSystemDescriptor)."
          },
          "performanceLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level (e.g., Below Basic, Basic, Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method used for this performance level definition."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score required to achieve this performance level."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score within this performance level."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level definition for an assessment, defining cut scores and descriptors for categorizing student performance (e.g., Below Basic, Basic, Proficient, Advanced). Collection child of Assessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentPeriodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The period of time in which the assessment is administered (e.g., BOY, MOY, EOY)."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the assessment is to be administered."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the assessment is to be administered."
                }
              },
              "required": [
                "assessmentPeriodDescriptor"
              ]
            },
            "description": "A period associated with an assessment, describing when the assessment is administered. Collection child of Assessment. Items unique by (assessmentPeriodDescriptor)."
          },
          "scores": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The method that the administrator of the assessment uses to report the performance and achievement of all students (e.g., Scale score, Raw score, Percentile)."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score possible on this assessment score."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score possible on this assessment score."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result (e.g., Integer, Decimal, Level)."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A score definition for an assessment, describing how results are reported (e.g., scale score, raw score, percentile). Collection child of Assessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assessmentIdentifier",
          "namespace",
          "assessmentTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "AssessmentAdministration": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assigningEducationOrganizationSourcedId, assessmentIdentifier, namespace, administrationIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization which contracts for or administers the assessment. Roster FK to oneroster:org.sourcedId (module EdOrg convention; schools/LEAs are OneRoster projections).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment being administered.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the assessment in the context of its administration."
          },
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Anticipated dates for the assessment administration window."
          },
          "assessmentBatteryParts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentBatteryPartName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Battery part name offered in this administration."
                }
              },
              "required": [
                "assessmentBatteryPartName"
              ],
              "description": "assessmentBatteryPartsItem value."
            },
            "description": "Parts of the assessment battery offered in this administration."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assigningEducationOrganizationSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationIdentifier",
          "recordState",
          "updatedAt"
        ]
      },
      "AssessmentAdministrationParticipation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assigningEducationOrganizationSourcedId, assessmentIdentifier, namespace, administrationIdentifier, participatingEducationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assigning education organization of the parent administration.",
            "x-references": "assessmentAdministration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the parent administration."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent administration."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "participatingEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The participating education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "administrationPointOfContacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Education organization of the contact."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Contact email."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Contact first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Contact last surname."
                },
                "loginId": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Contact login id."
                }
              },
              "required": [
                "educationOrganizationId",
                "electronicMailAddress",
                "firstName",
                "lastSurname"
              ],
              "description": "administrationPointOfContactsItem value."
            },
            "description": "Pre-identified contacts for education organizations administering the assessment."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assigningEducationOrganizationSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationIdentifier",
          "participatingEducationOrganizationSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "AssessmentBatteryPart": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assessmentIdentifier, namespace, assessmentBatteryPartName). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this battery part belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "assessmentBatteryPartName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The name of the part of an assessment battery."
          },
          "objectiveAssessments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Objective assessment identification code."
                }
              },
              "required": [
                "identificationCode"
              ],
              "description": "objectiveAssessmentsItem value."
            },
            "description": "Objective assessments administered by this battery part. Items unique by (identificationCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assessmentIdentifier",
          "namespace",
          "assessmentBatteryPartName",
          "recordState",
          "updatedAt"
        ]
      },
      "AssessmentItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assessmentIdentifier, namespace, identificationCode). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this item belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to this assessment item."
          },
          "assessmentItemCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Category or type of the assessment item (e.g., multiple choice, essay)."
          },
          "maxRawScore": {
            "type": "number",
            "description": "The maximum raw score for this item."
          },
          "expectedTimeAssessed": {
            "type": "string",
            "maxLength": 30,
            "description": "The expected time to assess this item."
          },
          "nomenclature": {
            "type": "string",
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used."
          },
          "assessmentItemUri": {
            "type": "string",
            "maxLength": 255,
            "description": "URI to the assessment item content."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this assessment item record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assessmentIdentifier",
          "namespace",
          "identificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "AssessmentScoreRangeLearningStandard": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assessmentIdentifier, namespace, scoreRangeId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment with which the score range is associated.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment."
          },
          "scoreRangeId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to the score range."
          },
          "minimumScore": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "The minimum score in the score range."
          },
          "maximumScore": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "The maximum score in the score range."
          },
          "assessmentReportingMethodDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The assessment reporting method for the score range."
          },
          "objectiveAssessmentIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Optional objective assessment identification code within the assessment (assessmentIdentifier + namespace + this code). Association integrity enforced at command layer."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Learning standard id associated with the score range."
                }
              },
              "required": [
                "learningStandardId"
              ],
              "description": "learningStandardsItem value."
            },
            "description": "Learning standards associated with the score range. Nested resource references validated at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assessmentIdentifier",
          "namespace",
          "scoreRangeId",
          "minimumScore",
          "maximumScore",
          "learningStandards",
          "recordState",
          "updatedAt"
        ]
      },
      "BalanceSheetDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, code, fiscalYear). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "code",
          "fiscalYear",
          "recordState",
          "updatedAt"
        ]
      },
      "BellSchedule": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, bellScheduleName). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this bell schedule belongs to. Establishes the cross-module FK into OneRoster.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "bellScheduleName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the bell schedule (e.g. 'Regular', 'Early Release', 'Assembly')."
          },
          "totalInstructionalTime": {
            "type": "string",
            "maxLength": 30,
            "description": "The total instructional time in the bell schedule (HH:MM format or minutes)."
          },
          "startTime": {
            "type": "string",
            "maxLength": 15,
            "description": "The start time for the bell schedule (HH:MM or HH:MM:SS format)."
          },
          "endTime": {
            "type": "string",
            "maxLength": 15,
            "description": "The end time for the bell schedule (HH:MM or HH:MM:SS format)."
          },
          "alternativeName": {
            "type": "string",
            "maxLength": 60,
            "description": "An alternative or abbreviated name for the bell schedule."
          },
          "classPeriods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "classPeriodName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The name of the class period assigned to this bell schedule."
                }
              },
              "required": [
                "classPeriodName"
              ]
            },
            "description": "An association between a bell schedule and a class period, establishing which class periods are part of a given bell schedule. Each row represents one class period assignment. Items unique by (classPeriodName)."
          },
          "dates": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date",
                  "description": "The specific calendar date on which this bell schedule is in effect."
                }
              },
              "required": [
                "date"
              ]
            },
            "description": "A specific calendar date on which a bell schedule is in effect. Each row represents one date assignment to a bell schedule. Items unique by (date)."
          },
          "meetingTimes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "startTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The start time of this meeting time block (HH:MM or HH:MM:SS format)."
                },
                "endTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The end time of this meeting time block (HH:MM or HH:MM:SS format)."
                },
                "officialAttendancePeriod": {
                  "type": "boolean",
                  "description": "Indicates whether this meeting time is the official attendance period for reporting purposes."
                }
              },
              "required": [
                "startTime",
                "endTime"
              ]
            },
            "description": "A meeting time window within a bell schedule, defining a start time and end time for a class period slot. Each row represents one time block in the bell schedule. Items unique by (startTime, endTime)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this bell schedule record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "bellScheduleName",
          "updatedAt"
        ]
      },
      "Calendar": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, calendarCode, schoolYear). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school owning this calendar. Establishes the cross-module FK into OneRoster.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to a calendar. Unique within the school and school year."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year for which the calendar is defined (e.g. 2025 for the 2024-2025 school year)."
          },
          "calendarTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of calendar (e.g. Student Specific, IEP, School). References the CalendarTypeDescriptor governed value."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level served by this calendar (e.g. First grade, Ninth grade). References the GradeLevelDescriptor governed value."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level served by a calendar. A calendar may serve multiple grade levels; each row represents one grade level association. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this calendar record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "calendarCode",
          "schoolYear",
          "calendarTypeDescriptor",
          "updatedAt"
        ]
      },
      "CalendarDate": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, calendarCode, schoolYear, date). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The school's OneRoster sourcedId. FK to calendar — together with calendarCode and schoolYear forms the composite reference to the parent calendar.",
            "x-references": "calendar.schoolSourcedId",
            "x-references-legs": [
              "calendarCode",
              "schoolYear"
            ],
            "x-onDelete": "soft-cascade"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The calendar code identifying the parent calendar within the school and school year."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year of the parent calendar."
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "The specific calendar date (ISO 8601 date). The key discriminator within the parent calendar."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this calendar date record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "calendarCode",
          "schoolYear",
          "date",
          "updatedAt"
        ]
      },
      "CalendarDateCalendarEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, calendarCode, schoolYear, date, calendarEventDescriptor).",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The school's OneRoster sourcedId. FK to calendarDate — together with calendarCode, schoolYear, and date forms the composite reference to the parent calendar date.",
            "x-references": "calendarDate.schoolSourcedId",
            "x-references-legs": [
              "calendarCode",
              "schoolYear",
              "date"
            ],
            "x-onDelete": "soft-cascade"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The calendar code identifying the parent calendar."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year of the parent calendar."
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "The specific calendar date this event belongs to."
          },
          "calendarEventDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of calendar event (e.g. Instructional day, Holiday, Teacher only day, Make-up day). References the CalendarEventDescriptor governed value."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this calendar event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "calendarCode",
          "schoolYear",
          "date",
          "calendarEventDescriptor",
          "updatedAt"
        ]
      },
      "Candidate": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, candidateIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a candidate."
          },
          "personalTitlePrefix": {
            "type": "string",
            "maxLength": 30,
            "description": "Personal title prefix."
          },
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "Legal first name."
          },
          "middleName": {
            "type": "string",
            "maxLength": 75,
            "description": "Middle name."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "Legal last/surname."
          },
          "generationCodeSuffix": {
            "type": "string",
            "maxLength": 10,
            "description": "Generation suffix."
          },
          "maidenName": {
            "type": "string",
            "maxLength": 75,
            "description": "Maiden name."
          },
          "preferredFirstName": {
            "type": "string",
            "maxLength": 75,
            "description": "Preferred first name."
          },
          "preferredLastSurname": {
            "type": "string",
            "maxLength": 75,
            "description": "Preferred last surname."
          },
          "sexDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Sex of the candidate."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "Gender identity."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Date of birth."
          },
          "birthCity": {
            "type": "string",
            "maxLength": 30,
            "description": "City of birth."
          },
          "birthStateAbbreviationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "State of birth."
          },
          "birthInternationalProvince": {
            "type": "string",
            "maxLength": 150,
            "description": "International province of birth."
          },
          "birthCountryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Country of birth."
          },
          "dateEnteredUS": {
            "type": "string",
            "format": "date",
            "description": "Date entered the US."
          },
          "multipleBirthStatus": {
            "type": "boolean",
            "description": "Multiple birth status."
          },
          "birthSexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Birth sex."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "City."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "Postal code."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Street number and name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "State abbreviation."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "Apartment/room/suite."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "Addresses."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "countryDescriptor",
                "addressLine1"
              ]
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ]
            },
            "description": "Telephone numbers."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Email address."
                },
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Email type."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailAddress",
                "electronicMailTypeDescriptor"
              ]
            },
            "description": "Electronic mail addresses."
          },
          "otherNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Other name type."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Title prefix."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "First name."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Middle name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Last surname."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "Generation suffix."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Other names."
          },
          "profileThumbnail": {
            "type": "string",
            "maxLength": 255,
            "description": "Profile thumbnail URI."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "Races."
          },
          "citizenship": {
            "type": "object",
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ]
                },
                "description": "Visas."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship."
          },
          "economicDisadvantageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Economic disadvantage."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "candidateCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Candidate characteristic."
                }
              },
              "required": [
                "candidateCharacteristicDescriptor"
              ]
            },
            "description": "Candidate characteristics."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Limited English proficiency."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ]
                  },
                  "description": "Language uses."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "Languages."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Diagnosis."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "Disabilities."
          },
          "displacementStatus": {
            "type": "string",
            "maxLength": 30,
            "description": "Displacement status."
          },
          "indicators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator group."
                },
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator name."
                },
                "indicatorBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Indicator begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Indicator end date."
                },
                "indicator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "indicatorName",
                "indicatorBeginDate",
                "indicator"
              ]
            },
            "description": "Indicators."
          },
          "loginId": {
            "type": "string",
            "maxLength": 120,
            "description": "Login ID."
          },
          "tuitionCost": {
            "type": "number",
            "description": "Tuition cost."
          },
          "backgroundCheck": {
            "type": "object",
            "properties": {
              "backgroundCheckTypeDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Background check type."
              },
              "backgroundCheckRequestedDate": {
                "type": "string",
                "format": "date",
                "description": "Requested date."
              },
              "backgroundCheckStatusDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "Status."
              },
              "backgroundCheckCompletedDate": {
                "type": "string",
                "format": "date",
                "description": "Completed date."
              },
              "fingerprint": {
                "type": "boolean",
                "description": "Fingerprint indicator."
              }
            },
            "required": [
              "backgroundCheckTypeDescriptor",
              "backgroundCheckRequestedDate"
            ],
            "description": "Background check."
          },
          "englishLanguageExamDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "English language exam."
          },
          "previousCareerDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Previous career."
          },
          "firstGenerationStudent": {
            "type": "boolean",
            "description": "First-generation student indicator."
          },
          "ePPProgramDegrees": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Academic subject."
                },
                "ePPDegreeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "EPP degree type."
                },
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "academicSubjectDescriptor",
                "ePPDegreeTypeDescriptor",
                "gradeLevelDescriptor"
              ]
            },
            "description": "EPP program degrees."
          },
          "personId": {
            "type": "string",
            "maxLength": 32,
            "description": "Optional correlated person id.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Source system for the optional person correlation."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "candidateIdentifier",
          "firstName",
          "lastSurname",
          "sexDescriptor",
          "birthDate",
          "recordState",
          "updatedAt"
        ]
      },
      "CandidateEducatorPreparationProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, candidateIdentifier, educationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the EPP.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "EPP program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "EPP program type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Association begin date."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Association end date."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Reason exited."
          },
          "ePPProgramPathwayDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "EPP program pathway."
          },
          "candidateIndicators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator group."
                },
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator name."
                },
                "indicatorBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                },
                "indicator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "indicatorName",
                "indicatorBeginDate",
                "indicator"
              ]
            },
            "description": "Candidate indicators for this association."
          },
          "degreeSpecializations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "majorSpecialization": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Major specialization."
                },
                "minorSpecialization": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Minor specialization."
                },
                "specializationBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Specialization begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Specialization end date."
                }
              },
              "required": [
                "majorSpecialization",
                "specializationBeginDate"
              ]
            },
            "description": "Degree specializations."
          },
          "cohortYears": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "schoolYear": {
                  "type": "integer",
                  "description": "School year."
                },
                "cohortYearTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Cohort year type."
                },
                "termDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Term."
                }
              },
              "required": [
                "schoolYear",
                "cohortYearTypeDescriptor"
              ]
            },
            "description": "Cohort years."
          },
          "applicationIdentifier": {
            "type": "string",
            "maxLength": 20,
            "description": "Optional application identifier (Application is out of tier; command-layer)."
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "maxLength": 32,
            "description": "Optional applicant profile identifier."
          },
          "applicationEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional application education organization sourcedId."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "candidateIdentifier",
          "educationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "CandidateIdentificationCode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, candidateIdentifier, candidateIdentificationSystemDescriptor, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "candidateIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Identification system."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The identification code value."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Assigning organization identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "candidateIdentifier",
          "candidateIdentificationSystemDescriptor",
          "educationOrganizationSourcedId",
          "identificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "CandidateRelationshipToStaffAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, candidateIdentifier, staffSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffToCandidateRelationshipDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Relationship type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Relationship begin date."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Relationship end date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "candidateIdentifier",
          "staffSourcedId",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "Certification": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, certificationIdentifier, namespace).",
            "readOnly": true
          },
          "certificationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the certification."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the certification, typically associated with the issuing authority."
          },
          "certificationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "The title of the certification."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that authorizes the certification, often a state education agency.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "certificationLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The level or category of the certification."
          },
          "certificationFieldDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The field of certification."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level certified for teaching."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade level(s) certified for teaching. Folded descriptor collection."
          },
          "routes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "certificationRouteDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The process, program, or pathway used to obtain the certification."
                }
              },
              "required": [
                "certificationRouteDescriptor"
              ]
            },
            "description": "Certification routes. Folded descriptor collection."
          },
          "certificationStandardDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The standard, law, or policy defining the certification."
          },
          "minimumDegreeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The minimum level of degree, if any, required for the certification."
          },
          "educatorRoleDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The role authorized by the certification."
          },
          "populationServedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of students that the certification is offered and tailored to."
          },
          "instructionalSettingDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting authorized by the certification."
          },
          "certificationExams": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "certificationExamIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "Certification exam identifier. Cross-fragment FK to certificationExam; validated at command layer."
                },
                "certificationExamNamespace": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Certification exam namespace."
                }
              },
              "required": [
                "certificationExamIdentifier",
                "certificationExamNamespace"
              ]
            },
            "description": "Certification exams required for the certification. Folded collection; FK to certificationExam validated at command layer (schema-level FK does not survive jsonb fold)."
          },
          "effectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification is offered."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification offering is expected to end."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "certificationIdentifier",
          "namespace",
          "certificationTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "CertificationExam": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, certificationExamIdentifier, namespace).",
            "readOnly": true
          },
          "certificationExamIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the certification exam."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the certification exam."
          },
          "certificationExamTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The title of the certification exam."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the certification exam.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "certificationExamTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type or category of the certification exam."
          },
          "effectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification exam is offered."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification exam offering is expected to end."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "certificationExamIdentifier",
          "namespace",
          "certificationExamTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "CertificationExamResult": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, certificationExamIdentifier, namespace, personId, sourceSystemDescriptor, certificationExamDate).",
            "readOnly": true
          },
          "certificationExamIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Certification exam identifier (certificationExam natural-key leg).",
            "x-references": "certificationExam.certificationExamIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace leg of the certification exam natural key."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person who took the certification exam (person natural-key leg).",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system leg of the person natural key."
          },
          "certificationExamDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification exam is taken."
          },
          "attemptNumber": {
            "type": "integer",
            "description": "The number of the person's attempt for the certification exam."
          },
          "certificationExamScore": {
            "type": "number",
            "description": "The score result for the certification exam attempt."
          },
          "certificationExamPassIndicator": {
            "type": "boolean",
            "description": "Indicator that the person passed the certification exam."
          },
          "certificationExamStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The status of the certification exam attempt."
          },
          "studentAssessmentIdentifier": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional studentAssessmentIdentifier for a detailed assessment result. Full studentAssessment FK validated at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "certificationExamIdentifier",
          "namespace",
          "personId",
          "sourceSystemDescriptor",
          "certificationExamDate",
          "recordState",
          "updatedAt"
        ]
      },
      "ChartOfAccount": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the account is valid."
          },
          "accountName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the account."
          },
          "accountCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of the account (e.g., Fund, Function, Object)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "recordState",
          "updatedAt"
        ]
      },
      "ClassPeriod": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, classPeriodName). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this class period belongs to. Establishes the cross-module FK into OneRoster.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classPeriodName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the class period (e.g. '01 - Traditional', 'Homeroom', 'Lunch')."
          },
          "officialAttendancePeriod": {
            "type": "boolean",
            "description": "Indicates whether this class period is the official attendance-taking period for reporting purposes."
          },
          "meetingTimes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "startTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The start time of this class period meeting time (HH:MM or HH:MM:SS format)."
                },
                "endTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The end time of this class period meeting time (HH:MM or HH:MM:SS format)."
                }
              },
              "required": [
                "startTime",
                "endTime"
              ]
            },
            "description": "A meeting time definition for a class period, specifying the start and end time of the period. Each row represents one time window for a class period within a school. Items unique by (startTime, endTime)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this class period record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "classPeriodName",
          "updatedAt"
        ]
      },
      "Cohort": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "cohortDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "The description of the cohort and its purpose."
          },
          "cohortTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of cohort (e.g., Academic Intervention, Attendance Intervention, Study Hall)."
          },
          "cohortScopeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The scope of cohort (e.g., District, School, Classroom)."
          },
          "academicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The academic subject associated with the cohort."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this cohort record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "cohortIdentifier",
          "cohortTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "CommunityOrganization": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "communityOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier for the community organization."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full legally accepted name of the community organization."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 75,
            "description": "A short name for the community organization."
          },
          "webSite": {
            "type": "string",
            "maxLength": 255,
            "description": "The URL of the community organization's website."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The operational status of the community organization (e.g., Active, Inactive)."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a community organization. An organization may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this organization. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a community organization. An organization may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a community organization by an external system. An organization may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a community organization, classified by type (e.g. Main, Fax). An organization may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this community organization record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "communityOrganizationId",
          "nameOfInstitution",
          "recordState",
          "updatedAt"
        ]
      },
      "CommunityProvider": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "communityProviderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier for the community provider."
          },
          "communityOrganizationId": {
            "type": "string",
            "maxLength": 60,
            "description": "The community organization this provider belongs to, if applicable."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full legally accepted name of the community provider."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 75,
            "description": "A short name for the community provider."
          },
          "providerCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the provider (e.g., Center-based, Family Child Care)."
          },
          "providerStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The operating status of the provider (e.g., Active, Inactive, Closed)."
          },
          "providerProfitStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The profit status of the provider (e.g., For Profit, Non Profit)."
          },
          "schoolIndicator": {
            "type": "boolean",
            "description": "Indicates whether the provider is also a school."
          },
          "licenseExemptIndicator": {
            "type": "boolean",
            "description": "Indicates whether the provider is exempt from licensing requirements."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a community provider. A provider may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this provider. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a community provider. A provider may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a community provider by an external system. A provider may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a community provider, classified by type (e.g. Main, Fax). A provider may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this community provider record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "communityProviderId",
          "nameOfInstitution",
          "providerCategoryDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "CommunityProviderLicense": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "communityProviderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the community provider holding this license."
          },
          "licenseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The unique identifier of the license."
          },
          "licensingOrganization": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The organization that issued the license."
          },
          "licenseTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of license (e.g., child care, family care)."
          },
          "licenseEffectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the license became effective."
          },
          "licenseExpirationDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the license expires."
          },
          "licenseStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The status of the license (e.g., Active, Suspended, Revoked)."
          },
          "authorizedFacilityCapacity": {
            "type": "integer",
            "description": "The maximum number of individuals authorized to be served by the facility."
          },
          "oldestAgeAuthorized": {
            "type": "integer",
            "description": "The oldest age of individuals the facility is authorized to serve."
          },
          "youngestAgeAuthorized": {
            "type": "integer",
            "description": "The youngest age of individuals the facility is authorized to serve."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this license record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "communityProviderId",
          "licenseIdentifier",
          "licensingOrganization",
          "licenseTypeDescriptor",
          "licenseEffectiveDate",
          "recordState",
          "updatedAt"
        ]
      },
      "CompetencyObjective": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, objective, objectiveGradeLevelDescriptor).",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId that owns this competency objective (roster-reference boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "objective": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The designated title of the competency objective."
          },
          "objectiveGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grade level for which the competency objective is targeted."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "The description of the student competency objective."
          },
          "successCriteria": {
            "type": "string",
            "maxLength": 150,
            "description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a competency objective."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "objective",
          "objectiveGradeLevelDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "ConformanceEvidence": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable unique identifier for this conformance evidence record.",
            "readOnly": true
          },
          "evidenceType": {
            "type": "string",
            "enum": [
              "udm_coverage",
              "descriptor_governance",
              "roster_boundary"
            ],
            "description": "The type of conformance evidence: `udm_coverage` proves resource coverage breadth, `descriptor_governance` proves the descriptor registry is complete, `roster_boundary` proves roster-reference compliance."
          },
          "coverageData": {
            "type": "object",
            "description": "Structured evidence payload containing coverage metrics, missing resources, or compliance violations as appropriate for the evidence type."
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when this evidence record was generated."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed row-creation timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "id",
          "evidenceType",
          "coverageData",
          "generatedAt",
          "createdAt"
        ]
      },
      "Contact": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, contactUniqueId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "A unique alphanumeric code assigned to a contact. This is the Ed-Fi contact identity (not a roster sourcedId)."
          },
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The contact's legal first name."
          },
          "middleName": {
            "type": "string",
            "maxLength": 75,
            "description": "The contact's middle name, if any."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The contact's legal last/surname."
          },
          "generationCodeSuffix": {
            "type": "string",
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III)."
          },
          "maidenName": {
            "type": "string",
            "maxLength": 75,
            "description": "The contact's maiden name, if applicable."
          },
          "personalTitlePrefix": {
            "type": "string",
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the contact."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The contact's sex."
          },
          "loginId": {
            "type": "string",
            "maxLength": 60,
            "description": "The login ID for the user; used for entry into a system or service."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which the address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state or jurisdiction in which the address is located."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of the address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which the address is located."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "A postal address associated with a contact, discriminated by address type. Multiple addresses per contact are supported (home, mailing, physical, etc.). Items unique by (addressTypeDescriptor, city, postalCode, streetNumberName, stateAbbreviationDescriptor)."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "contactCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic or trait attributed to the contact — descriptor reference."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or became inapplicable."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "contactCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to a contact. Collection child of Contact, keyed on (tenant, contactUniqueId, contactCharacteristicDescriptor). Items unique by (contactCharacteristicDescriptor)."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the contact."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the contact."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a contact, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The organization code or name assigning the identification code."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to the contact by the organization."
                }
              },
              "required": [
                "assigningOrganizationIdentificationCode",
                "identificationCode"
              ]
            },
            "description": "A code assigned to a contact by an organization for identification purposes. Collection child of Contact, keyed on (tenant, contactUniqueId, assigningOrganizationIdentificationCode, identificationCode). Items unique by (assigningOrganizationIdentificationCode, identificationCode)."
          },
          "identificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity — descriptor reference."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose — descriptor reference."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing organization — descriptor reference."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to identify a contact. Collection child of Contact, keyed on (tenant, contactUniqueId, identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a contact, discriminated by address type. Items unique by (addressTypeDescriptor)."
          },
          "languageUses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The language this use context applies to."
                },
                "languageUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A description of how the language is used (e.g., Home language, Dominant language, Correspondence language)."
                }
              },
              "required": [
                "languageDescriptor",
                "languageUseDescriptor"
              ]
            },
            "description": "A use context for a language spoken by a contact (e.g., home language, dominant language), discriminated by both language and language-use descriptor. Items unique by (languageDescriptor, languageUseDescriptor)."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language the contact speaks or understands."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language spoken or understood by the contact, discriminated by language descriptor. Items unique by (languageDescriptor)."
          },
          "otherNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a contact (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The contact's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The contact's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The contact's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the contact is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor)."
          },
          "personalIdentificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity — descriptor reference."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose — descriptor reference."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing organization — descriptor reference."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document held by the contact. Collection child of Contact, keyed on (tenant, contactUniqueId, identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category (e.g. American Indian - Alaska Native, Asian, Black - African American, Native Hawaiian - Pacific Islander, White) — descriptor reference."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "The general racial category which most clearly reflects the individual's recognition of their community or with which the contact most identifies. Collection child of Contact, keyed on (tenant, contactUniqueId, raceDescriptor). Items unique by (raceDescriptor)."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of communication number (e.g., Home, Mobile, Work, Emergency)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number associated with a contact, discriminated by telephone number type. Items unique by (telephoneNumberTypeDescriptor, telephoneNumber)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this contact record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "contactUniqueId",
          "firstName",
          "lastSurname",
          "recordState",
          "updatedAt"
        ]
      },
      "ContactIdentificationCode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, contactUniqueId, contactIdentificationSystemDescriptor, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The contact this identification code belongs to.",
            "x-references": "contact.contactUniqueId",
            "x-onDelete": "cascade"
          },
          "contactIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Identification system."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context for this contact identification code. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identification code value."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Assigning organization code or name."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "contactUniqueId",
          "contactIdentificationSystemDescriptor",
          "educationOrganizationSourcedId",
          "identificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "Course": {
        "type": "object",
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster organization sourcedId that owns this course (Ed-Fi educationOrganizationId). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The course code assigned by the organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "courseTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The descriptive name of the course (OneRoster title). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "numberOfParts": {
            "type": "integer",
            "minimum": 1,
            "description": "The number of parts identified for a course. Ed-Fi-owned extends field."
          },
          "courseDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "A description of the content standards and goals covered in the course."
          },
          "timeRequiredForCompletion": {
            "type": "integer",
            "minimum": 0,
            "description": "The actual or estimated number of clock minutes required for class completion."
          },
          "dateCourseAdopted": {
            "type": "string",
            "format": "date",
            "description": "The date the course was adopted by the education organization."
          },
          "highSchoolCourseRequirement": {
            "type": "boolean",
            "description": "An indication that this course may satisfy high school graduation requirements."
          },
          "maxCompletionsForCredit": {
            "type": "integer",
            "minimum": 1,
            "description": "Designates how many times the course may be taken with credit received by the student."
          },
          "minimumAvailableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits awarded."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor to Carnegie units."
              }
            },
            "description": "The minimum amount of credit available to a student who successfully completes the course."
          },
          "maximumAvailableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits awarded."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor to Carnegie units."
              }
            },
            "description": "The maximum amount of credit available to a student who successfully completes the course."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area descriptor."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "Academic subject areas associated with the course."
          },
          "competencyLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "competencyLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The competency level descriptor."
                }
              },
              "required": [
                "competencyLevelDescriptor"
              ]
            },
            "description": "Competency levels associated with the course."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The identification system descriptor."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code value."
                }
              },
              "required": [
                "courseIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "Coding schemes used to identify the course."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The learning standard identifier this course addresses."
                }
              },
              "required": [
                "learningStandardId"
              ]
            },
            "description": "Learning standards addressed by the course."
          },
          "levelCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The course level characteristic descriptor."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "Course level characteristics (Honors, AP, IB, etc.)."
          },
          "offeredGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level descriptor."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Grade levels at which the course is offered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this course record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this course is deleted."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "courseCode",
          "courseTitle",
          "numberOfParts",
          "recordState",
          "dateLastModified"
        ]
      },
      "CourseExtension": {
        "type": "object",
        "properties": {
          "courseSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Shared natural id with the OneRoster course this course extension belongs to 1:1. FK CASCADE so deleting the course reaps the companion.",
            "x-references": "oneroster:course.sourcedId",
            "x-onDelete": "cascade"
          },
          "numberOfParts": {
            "type": "integer",
            "minimum": 1,
            "description": "The number of parts identified for a course. Ed-Fi-owned extends field."
          },
          "courseDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "A description of the content standards and goals covered in the course."
          },
          "timeRequiredForCompletion": {
            "type": "integer",
            "minimum": 0,
            "description": "The actual or estimated number of clock minutes required for class completion."
          },
          "dateCourseAdopted": {
            "type": "string",
            "format": "date",
            "description": "The date the course was adopted by the education organization."
          },
          "highSchoolCourseRequirement": {
            "type": "boolean",
            "description": "An indication that this course may satisfy high school graduation requirements."
          },
          "maxCompletionsForCredit": {
            "type": "integer",
            "minimum": 1,
            "description": "Designates how many times the course may be taken with credit received by the student."
          },
          "minimumAvailableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits awarded."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor to Carnegie units."
              }
            },
            "description": "The minimum amount of credit available to a student who successfully completes the course."
          },
          "maximumAvailableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits awarded."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor to Carnegie units."
              }
            },
            "description": "The maximum amount of credit available to a student who successfully completes the course."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area descriptor."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "Academic subject areas associated with the course."
          },
          "competencyLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "competencyLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The competency level descriptor."
                }
              },
              "required": [
                "competencyLevelDescriptor"
              ]
            },
            "description": "Competency levels associated with the course."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The identification system descriptor."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code value."
                }
              },
              "required": [
                "courseIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "Coding schemes used to identify the course."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The learning standard identifier this course addresses."
                }
              },
              "required": [
                "learningStandardId"
              ]
            },
            "description": "Learning standards addressed by the course."
          },
          "levelCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The course level characteristic descriptor."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "Course level characteristics (Honors, AP, IB, etc.)."
          },
          "offeredGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level descriptor."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Grade levels at which the course is offered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this course record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this course is deleted."
          }
        },
        "required": [
          "courseSourcedId"
        ]
      },
      "CourseOffering": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, localCourseCode, schoolYear, sessionName).",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId identifying the school offering this course (roster-reference boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "localCourseTitle": {
            "type": "string",
            "maxLength": 120,
            "description": "The descriptive name given to a course of study offered in the school."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The identifier for the school year in which the course is offered."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar session in which the course is offered."
          },
          "instructionalTimePlanned": {
            "type": "integer",
            "minimum": 0,
            "description": "The planned total number of clock minutes of instruction for this course offering."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the referenced course (roster org). Course identity is (educationOrganizationId, courseCode) on the Ed-Fi wire; the course row lives on oneroster:course.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The course code identifying the referenced parent course within the education organization. Paired with educationOrganizationId; validated at the command layer against the oneroster:course master (projections cannot back FKs)."
          },
          "courseLevelCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of course level characteristic (e.g., Honors, AP, IB, Dual Credit)."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a course offering level (e.g., Honors, AP, IB), discriminated by the course level characteristic descriptor. Collection child of CourseOffering. Items unique by (courseLevelCharacteristicDescriptor)."
          },
          "curriculumUseds": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "curriculumUsedDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of curriculum used in the course offering."
                }
              },
              "required": [
                "curriculumUsedDescriptor"
              ]
            },
            "description": "A curriculum used in a course offering, discriminated by the curriculum used descriptor. Collection child of CourseOffering. Items unique by (curriculumUsedDescriptor)."
          },
          "offeredGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level at which the course offering is offered (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level at which a course offering is offered, discriminated by the grade level descriptor. Collection child of CourseOffering. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "localCourseCode",
          "schoolYear",
          "sessionName",
          "recordState",
          "updatedAt"
        ]
      },
      "CourseTranscript": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationId, courseCode, schoolYear, termDescriptor, courseAttemptResultDescriptor).",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student (roster-reference boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the referenced course (roster org). Course identity is (educationOrganizationId, courseCode) on the Ed-Fi wire; the course row lives on oneroster:course.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The course code identifying the referenced course within the education organization. Paired with educationOrganizationId; validated at the command layer against the oneroster:course master (projections cannot back FKs)."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year during which the course was taken."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term in which the course was taken (e.g., Fall Semester, Spring Semester)."
          },
          "courseAttemptResultDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The result from the student's attempt to take the course (e.g., Pass, Fail, Incomplete)."
          },
          "finalLetterGradeEarned": {
            "type": "string",
            "maxLength": 20,
            "description": "The final indicator of student performance in a class as submitted by the instructor."
          },
          "finalNumericGradeEarned": {
            "type": "number",
            "description": "The final indicator of student performance in a class as submitted by the instructor, expressed as a numeric value."
          },
          "courseTitle": {
            "type": "string",
            "maxLength": 120,
            "description": "The descriptive name given to a course of study offered in a school or other institution or organization. In the case of a transcript this may be different from the official course title."
          },
          "alternativeCourseTitle": {
            "type": "string",
            "maxLength": 120,
            "description": "The descriptive name given to a course of study in which the student received credit that differs from the course title on the official transcript."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 120,
            "description": "The organization code or name assigning the course identification code."
          },
          "courseCatalogURL": {
            "type": "string",
            "maxLength": 255,
            "description": "The URL for the course catalog that defines the course identification code."
          },
          "earnedCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits or units of value awarded for the completion of a course."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value awarded for the completion of a course."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value awarded for the completion of a course."
          },
          "attemptedCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits or units of value attempted."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value attempted."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value attempted for a course."
          },
          "whenTakenGradeLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The student's grade level at time of course."
          },
          "methodCreditEarnedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The method the credits were earned (e.g., Classroom, Transferred)."
          },
          "courseRepeatCodeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Indicates that an academic course has been repeated by a student and how that repeat is to be computed in the student's academic record."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area (e.g., Mathematics, Science, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject area associated with a course transcript record, discriminated by the academic subject descriptor. Collection child of CourseTranscript. Items unique by (academicSubjectDescriptor)."
          },
          "alternativeCourseIdentificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A system that is used to identify the organization of subject matter and related learning experiences provided for the instruction of students (e.g., State course code, University course code)."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The alternative course identification code."
                }
              },
              "required": [
                "courseIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An alternative identification code for a course on a transcript, discriminated by the course identification system descriptor. Collection child of CourseTranscript. Items unique by (courseIdentificationSystemDescriptor)."
          },
          "coursePrograms": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseProgramName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "The formal name of the program of studies associated with the course on the student's transcript."
                },
                "courseProgramTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Special Education, Bilingual, Career and Technical Education)."
                }
              },
              "required": [
                "courseProgramName",
                "courseProgramTypeDescriptor"
              ]
            },
            "description": "A program associated with a course on a transcript, discriminated by program name and program type descriptor. Collection child of CourseTranscript. Items unique by (courseProgramName, courseProgramTypeDescriptor)."
          },
          "creditCategories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "creditCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A categorization for the course transcript credits awarded (e.g., Honors, AP, IB)."
                }
              },
              "required": [
                "creditCategoryDescriptor"
              ]
            },
            "description": "A credit category associated with a course transcript record, discriminated by the credit category descriptor. Collection child of CourseTranscript. Items unique by (creditCategoryDescriptor)."
          },
          "earnedAdditionalCredits": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "additionalCreditTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of additional credits earned (e.g., Advanced Placement, International Baccalaureate)."
                },
                "credits": {
                  "type": "number",
                  "description": "The value of additional credits or units of value earned."
                }
              },
              "required": [
                "additionalCreditTypeDescriptor",
                "credits"
              ]
            },
            "description": "Additional credits earned by a student for a course transcript, discriminated by the additional credit type descriptor. Collection child of CourseTranscript. Items unique by (additionalCreditTypeDescriptor)."
          },
          "partialCourseTranscriptAwards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "awardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the partial course transcript credits were awarded or earned."
                },
                "methodCreditEarnedDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The method the credits were earned (e.g., Classroom, Transferred)."
                },
                "letterGradeEarned": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 20,
                  "description": "The indicator of student performance for the partial course transcript award."
                },
                "earnedCredits": {
                  "type": "number",
                  "description": "The value of credits or units of value awarded for the partial course."
                }
              },
              "required": [
                "awardDate",
                "methodCreditEarnedDescriptor",
                "letterGradeEarned",
                "earnedCredits"
              ]
            },
            "description": "A partial course transcript award representing credits earned for a portion of a course, discriminated by award date, method credit earned descriptor, and letter grade earned. Collection child of CourseTranscript. Items unique by (awardDate, methodCreditEarnedDescriptor, letterGradeEarned)."
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The local identifier assigned to a section."
                },
                "schoolSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster organization sourcedId of the school offering the section."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The local code assigned by the school that identifies the course offering."
                },
                "sectionSchoolYear": {
                  "type": "integer",
                  "description": "The school year of the section."
                },
                "sectionTermDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The term descriptor for the section's session."
                }
              },
              "required": [
                "sectionIdentifier",
                "schoolSourcedId",
                "localCourseCode",
                "sectionSchoolYear",
                "sectionTermDescriptor"
              ]
            },
            "description": "An optional section reference associated with a course transcript, identifying the specific section in which the student was enrolled. Discriminated by section identifier, school, local course code, section school year, and term descriptor. Collection child of CourseTranscript. Items unique by (sectionIdentifier, schoolSourcedId, localCourseCode, sectionSchoolYear, sectionTermDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "courseCode",
          "schoolYear",
          "termDescriptor",
          "courseAttemptResultDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "Credential": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, credentialIdentifier, stateOfIssueStateAbbreviationDescriptor).",
            "readOnly": true
          },
          "credentialIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the credential."
          },
          "stateOfIssueStateAbbreviationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The abbreviation for the name of the state or extra-state jurisdiction in which a license/credential was issued."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the credential."
          },
          "credentialTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the category of the credential a person holds."
          },
          "issuanceDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an active credential was issued to a person."
          },
          "credentialFieldDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The field of certification for the credential."
          },
          "effectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an active credential held by a person was issued."
          },
          "expirationDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an active credential held by a person will expire."
          },
          "teachingCredentialDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indication of the category of a legal document giving authorization to perform teaching assignment services."
          },
          "teachingCredentialBasisDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indication of the pre-determined criteria for granting the teaching credential."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level certified for teaching."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade level(s) certified for teaching. Folded descriptor collection."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject to which the credential pertains."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "The academic subjects to which the credential pertains. Folded descriptor collection."
          },
          "endorsements": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "credentialEndorsement": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Endorsement attached to teaching certificates indicating areas of specialization."
                }
              },
              "required": [
                "credentialEndorsement"
              ]
            },
            "description": "Endorsements attached to teaching certificates. Folded string collection."
          },
          "certificationTitle": {
            "type": "string",
            "maxLength": 64,
            "description": "The title of the certification obtained by the person."
          },
          "certificationIdentifier": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional reference to the certification associated with the person's credential.",
            "x-references": "certification.certificationIdentifier",
            "x-references-legs": [
              "certificationNamespace"
            ],
            "x-onDelete": "restrict"
          },
          "certificationNamespace": {
            "type": "string",
            "maxLength": 255,
            "description": "Namespace leg of the optional certification reference."
          },
          "certificationRouteDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The process, program, or pathway used to obtain certification."
          },
          "boardCertificationIndicator": {
            "type": "boolean",
            "description": "Indicator that the credential was granted under the authority of a national board certification."
          },
          "credentialStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The current status of the credential."
          },
          "credentialStatusDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the credential status was effective."
          },
          "personId": {
            "type": "string",
            "maxLength": 32,
            "description": "The person who obtained and is holding the credential (person natural-key leg).",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Source system leg of the optional person reference."
          },
          "studentAcademicRecords": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student sourcedId leg of studentAcademicRecord."
                },
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization leg of studentAcademicRecord."
                },
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "School year leg of studentAcademicRecord."
                },
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term descriptor leg of studentAcademicRecord."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationId",
                "schoolYear",
                "termDescriptor"
              ]
            },
            "description": "Optional student academic records associated with the credential. Folded collection; FK validated at command layer."
          },
          "educatorRoleDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The specific roles or positions the credential is intended to authorize."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "credentialIdentifier",
          "stateOfIssueStateAbbreviationDescriptor",
          "namespace",
          "credentialTypeDescriptor",
          "issuanceDate",
          "recordState",
          "updatedAt"
        ]
      },
      "CredentialEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, credentialIdentifier, stateOfIssueStateAbbreviationDescriptor, credentialEventDate, credentialEventTypeDescriptor).",
            "readOnly": true
          },
          "credentialIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Credential identifier (credential natural-key leg).",
            "x-references": "credential.credentialIdentifier",
            "x-references-legs": [
              "stateOfIssueStateAbbreviationDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "stateOfIssueStateAbbreviationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "State of issue leg of the credential natural key."
          },
          "credentialEventDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year of the credential event."
          },
          "credentialEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of event associated with a person's credential."
          },
          "credentialEventReason": {
            "type": "string",
            "maxLength": 1024,
            "description": "The reason for the credential event, or any other descriptive text."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "credentialIdentifier",
          "stateOfIssueStateAbbreviationDescriptor",
          "credentialEventDate",
          "credentialEventTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "CrisisEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, crisisEventName).",
            "readOnly": true
          },
          "crisisEventName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name of the crisis event that occurred. Suggested format when no accepted name: Location + Crisis type + Year."
          },
          "crisisTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type or category of crisis."
          },
          "crisisDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Provides a textual description of the crisis event."
          },
          "crisisStartDate": {
            "type": "string",
            "format": "date",
            "description": "The year, month and day on which the crisis affected the student."
          },
          "crisisEndDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the crisis ceased to affect the student."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "crisisEventName",
          "crisisTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "Descriptor": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, code_value). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The Ed-Fi namespace URI that scopes this descriptor value (e.g. `uri://ed-fi.org/AcademicHonorCategoryDescriptor`)."
          },
          "codeValue": {
            "type": "string",
            "minLength": 1,
            "maxLength": 150,
            "description": "The short machine-readable code for this descriptor value within its namespace."
          },
          "descriptorType": {
            "type": "string",
            "enum": [
              "AbsenceEventCategoryDescriptor",
              "AcademicHonorCategoryDescriptor",
              "AcademicSubjectDescriptor",
              "AccommodationDescriptor",
              "AccountClassificationDescriptor",
              "AccountTypeDescriptor",
              "AchievementCategoryDescriptor",
              "AdditionalCreditTypeDescriptor",
              "AddressTypeDescriptor",
              "AdministrativeFundingControlDescriptor",
              "AssessmentCategoryDescriptor",
              "AssessmentIdentificationSystemDescriptor",
              "AssessmentItemCategoryDescriptor",
              "AssessmentItemResultDescriptor",
              "AssessmentPeriodDescriptor",
              "AssessmentReportingMethodDescriptor",
              "AssessmentScoreRangeLearningStandardDescriptor",
              "AttemptStatusDescriptor",
              "AttendanceEventCategoryDescriptor",
              "BarrierToInternetAccessInResidenceDescriptor",
              "BehaviorDescriptor",
              "CalendarEventDescriptor",
              "CalendarTypeDescriptor",
              "CareerPathwayDescriptor",
              "CharterApprovalAgencyTypeDescriptor",
              "CharterStatusDescriptor",
              "CitizenshipStatusDescriptor",
              "ClassroomPositionDescriptor",
              "CohortScopeDescriptor",
              "CohortTypeDescriptor",
              "CohortYearTypeDescriptor",
              "CompetencyLevelDescriptor",
              "ContactTypeDescriptor",
              "ContentClassDescriptor",
              "ContinuationOfServicesReasonDescriptor",
              "CostRateDescriptor",
              "CountryDescriptor",
              "CourseAttemptResultDescriptor",
              "CourseDefinedByDescriptor",
              "CourseGPAApplicabilityDescriptor",
              "CourseIdentificationSystemDescriptor",
              "CourseLevelCharacteristicDescriptor",
              "CourseRepeatCodeDescriptor",
              "CredentialFieldDescriptor",
              "CredentialTypeDescriptor",
              "CreditCategoryDescriptor",
              "CreditTypeDescriptor",
              "CurriculumUsedDescriptor",
              "DeliveryMethodDescriptor",
              "DiagnosisDescriptor",
              "DiplomaLevelDescriptor",
              "DiplomaTypeDescriptor",
              "DisabilityDescriptor",
              "DisabilityDesignationDescriptor",
              "DisabilityDeterminationSourceTypeDescriptor",
              "DisciplineActionLengthDifferenceReasonDescriptor",
              "DisciplineDescriptor",
              "EducationOrganizationCategoryDescriptor",
              "EducationOrganizationIdentificationSystemDescriptor",
              "EducationPlanDescriptor",
              "ElectronicMailTypeDescriptor",
              "EmploymentStatusDescriptor",
              "EntryGradeLevelReasonDescriptor",
              "EntryTypeDescriptor",
              "EventCircumstanceDescriptor",
              "ExitWithdrawTypeDescriptor",
              "FinancialCollectionDescriptor",
              "GradeLevelDescriptor",
              "GradePointAverageTypeDescriptor",
              "GradeTypeDescriptor",
              "GradebookEntryTypeDescriptor",
              "GradingPeriodDescriptor",
              "GraduationPlanTypeDescriptor",
              "GunFreeSchoolsActReportingStatusDescriptor",
              "HomelessPrimaryNighttimeResidenceDescriptor",
              "HomelessProgramServiceDescriptor",
              "IdentificationDocumentUseDescriptor",
              "IncidentLocationDescriptor",
              "InstitutionTelephoneNumberTypeDescriptor",
              "InteractivityStyleDescriptor",
              "InternetAccessDescriptor",
              "InternetAccessTypeInResidenceDescriptor",
              "InternetPerformanceInResidenceDescriptor",
              "InterventionClassDescriptor",
              "InterventionEffectivenessRatingDescriptor",
              "LanguageDescriptor",
              "LanguageInstructionProgramServiceDescriptor",
              "LanguageUseDescriptor",
              "LearningStandardCategoryDescriptor",
              "LearningStandardEquivalenceStrengthDescriptor",
              "LearningStandardScopeDescriptor",
              "LevelOfEducationDescriptor",
              "LicenseStatusDescriptor",
              "LicenseTypeDescriptor",
              "LimitedEnglishProficiencyDescriptor",
              "LocaleDescriptor",
              "LocalEducationAgencyCategoryDescriptor",
              "MagnetSpecialProgramEmphasisSchoolDescriptor",
              "MediumOfInstructionDescriptor",
              "MethodCreditEarnedDescriptor",
              "MigrantEducationProgramServiceDescriptor",
              "MonitoredDescriptor",
              "NeglectedOrDelinquentProgramDescriptor",
              "NeglectedOrDelinquentProgramServiceDescriptor",
              "NetworkPurposeDescriptor",
              "NonMedicalImmunizationExemptionDescriptor",
              "OperationalStatusDescriptor",
              "OtherNameTypeDescriptor",
              "ParticipationDescriptor",
              "ParticipationStatusDescriptor",
              "PerformanceBaseConversionDescriptor",
              "PerformanceLevelDescriptor",
              "PersonalInformationVerificationDescriptor",
              "PlatformTypeDescriptor",
              "PopulationServedDescriptor",
              "PostingResultDescriptor",
              "PostSecondaryEventCategoryDescriptor",
              "PostSecondaryInstitutionLevelDescriptor",
              "PrimaryLearningDeviceAccessDescriptor",
              "PrimaryLearningDeviceAwayFromSchoolDescriptor",
              "PrimaryLearningDeviceProviderDescriptor",
              "ProficiencyDescriptor",
              "ProgramAssignmentDescriptor",
              "ProgramCharacteristicDescriptor",
              "ProgramSponsorDescriptor",
              "ProgramTypeDescriptor",
              "ProgressDescriptor",
              "ProgressLevelDescriptor",
              "ProviderCategoryDescriptor",
              "ProviderProfitabilityDescriptor",
              "ProviderStatusDescriptor",
              "PublicationStatusDescriptor",
              "QuestionFormDescriptor",
              "RaceDescriptor",
              "ReasonExitedDescriptor",
              "ReasonNotTestedDescriptor",
              "RecognitionTypeDescriptor",
              "RelationDescriptor",
              "RepeatIdentifierDescriptor",
              "ReporterDescriptionDescriptor",
              "ResidencyStatusDescriptor",
              "ResponseIndicatorDescriptor",
              "ResponsibilityDescriptor",
              "RestraintEventReasonDescriptor",
              "ResultDatatypeTypeDescriptor",
              "RetestIndicatorDescriptor",
              "SchoolCategoryDescriptor",
              "SchoolChoiceImplementStatusDescriptor",
              "SchoolFoodServiceProgramServiceDescriptor",
              "SchoolTypeDescriptor",
              "SectionCharacteristicDescriptor",
              "SeparationDescriptor",
              "SeparationReasonDescriptor",
              "ServiceDescriptor",
              "SexDescriptor",
              "SourceSystemDescriptor",
              "SpecialEducationProgramServiceDescriptor",
              "SpecialEducationSettingDescriptor",
              "StaffClassificationDescriptor",
              "StaffIdentificationSystemDescriptor",
              "StaffLeaveEventCategoryDescriptor",
              "StateAbbreviationDescriptor",
              "StudentCharacteristicDescriptor",
              "StudentIdentificationSystemDescriptor",
              "StudentParticipationCodeDescriptor",
              "SurveyLevelDescriptor",
              "TeachingCredentialBasisDescriptor",
              "TeachingCredentialDescriptor",
              "TechnicalSkillsAssessmentDescriptor",
              "TelephoneNumberTypeDescriptor",
              "TermDescriptor",
              "TitleIPartAParticipantDescriptor",
              "TitleIPartASchoolDesignationDescriptor",
              "TribalAffiliationDescriptor",
              "VisaDescriptor",
              "WeaponDescriptor",
              "AncestryEthnicOriginDescriptor",
              "AssessmentLanguageDescriptor",
              "BalanceSheetDimensionDescriptor",
              "BusRouteDescriptor",
              "CalendarDescriptor",
              "ChartOfAccountIdentificationSystemDescriptor",
              "CoteachingStyleObservedDescriptor",
              "CTEProgramServiceDescriptor",
              "DisciplineIncidentParticipationCodeDescriptor",
              "EducatorRoleDescriptor",
              "EligibilityDelayReasonDescriptor",
              "EligibilityEvaluationTypeDescriptor",
              "EnrollmentTypeDescriptor",
              "EvaluationDelayReasonDescriptor",
              "EvaluationElementRatingLevelDescriptor",
              "EvaluationPeriodDescriptor",
              "EvaluationRatingLevelDescriptor",
              "EvaluationRatingStatusDescriptor",
              "EvaluationTypeDescriptor",
              "FunctionDimensionDescriptor",
              "FundDimensionDescriptor",
              "GeneralStudentProgramAssociationParticipationStatusDescriptor",
              "GiftedTalentedParticipationDescriptor",
              "GraduationPlanCategoryDescriptor",
              "HandicapTypeDescriptor",
              "IDEAPartDescriptor",
              "ImmunizationDateDescriptor",
              "ImmunizationTypeDescriptor",
              "IndicatorDescriptor",
              "IndicatorGroupDescriptor",
              "IndicatorLevelDescriptor",
              "InstructionalApproachDescriptor",
              "InstructionalDeliveryModeDescriptor",
              "LevelDescriptor",
              "LevelOfEducationGrantedDescriptor",
              "LocalAccountDescriptor",
              "ObjectDimensionDescriptor",
              "ObjectiveAssessmentAcademicSubjectDescriptor",
              "OperationalUnitDimensionDescriptor",
              "ProblemTypeDescriptor",
              "ProgramDimensionDescriptor",
              "ProjectDimensionDescriptor",
              "ProviderTypeDescriptor",
              "QuestionFormTypeDescriptor",
              "RatingLevelDescriptor",
              "ReportingTagDescriptor",
              "SchoolYearTypeDescriptor",
              "SectionTypeDescriptor",
              "SourceDimensionDescriptor",
              "SpecialEducationExitReasonDescriptor",
              "StudentGrowthTypeDescriptor",
              "SubmissionStatusDescriptor",
              "SurveyCategoryDescriptor",
              "SurveyResponseIndicatorDescriptor",
              "SurveySectionAssociationDescriptor",
              "TitleIPartAProgramServiceDescriptor",
              "TransportationPublicExpenseEligibilityTypeDescriptor",
              "TransportationTypeDescriptor",
              "TravelDayofWeekDescriptor",
              "TravelDirectionDescriptor",
              "WebServiceDescriptor"
            ],
            "description": "The Ed-Fi descriptor type this value belongs to. Discriminates over all 280 descriptor types in Data Standard v6.1."
          },
          "shortDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "A brief label for this descriptor value suitable for dropdowns and compact displays."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "A longer explanatory description of what this descriptor value means."
          },
          "effectiveBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The date this descriptor value became valid for use in the system."
          },
          "effectiveEndDate": {
            "type": "string",
            "format": "date",
            "description": "The date after which this descriptor value is no longer valid for new writes."
          },
          "standardStatus": {
            "type": "string",
            "enum": [
              "ed_fi_standard",
              "district_local",
              "platform_extension"
            ],
            "description": "Governance tier for this descriptor value: `ed_fi_standard` ships with the Ed-Fi Data Standard, `district_local` is a district-authored extension, `platform_extension` is an Alpha platform addition."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this descriptor value. Descriptors are typically `canonical` on creation; `soft_deleted` when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this descriptor is deleted: `api` for user-initiated DELETE, `import` for removal during a bulk import, `correction` for administrative data correction, `retention_policy` for automated retention sweeps."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "codeValue",
          "descriptorType",
          "shortDescription",
          "standardStatus",
          "updatedAt"
        ]
      },
      "DescriptorMapping": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, value, namespace, mappedValue, mappedNamespace). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "value": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The descriptor value being mapped from."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the source descriptor value."
          },
          "mappedValue": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The descriptor value being mapped to."
          },
          "mappedNamespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the target descriptor value."
          },
          "modelEntities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "modelEntityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Model entity the mapping applies to."
                }
              },
              "required": [
                "modelEntityDescriptor"
              ],
              "description": "modelEntitiesItem value."
            },
            "description": "Resources for which the descriptor mapping applies. Empty means all resources."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "value",
          "namespace",
          "mappedValue",
          "mappedNamespace",
          "recordState",
          "updatedAt"
        ]
      },
      "DisciplineAction": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, disciplineActionIdentifier, studentSourcedId, assignedSchoolSourcedId, disciplineDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "disciplineActionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "Identifier assigned by the education organization to the DisciplineAction."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who received the discipline action (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "assignedSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school to which the student was assigned at the time of the discipline action.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "disciplineDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the DisciplineAction."
          },
          "responsibilitySchoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school responsible for the student's discipline.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "disciplineActionLength": {
            "type": "number",
            "description": "The length of time in school days for the DisciplineAction."
          },
          "disciplineActionLengthDifferenceReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Indicates the reason for the difference, if any, between the official and actual discipline action length."
          },
          "actualDisciplineActionLength": {
            "type": "number",
            "description": "Indicates the actual length in school days of a student's disciplinary assignment."
          },
          "iepPlacementMeetingIndicator": {
            "type": "boolean",
            "description": "An indication of whether an Individualized Education Program (IEP) meeting was held concerning the discipline action."
          },
          "relatedToZeroTolerancePolicy": {
            "type": "boolean",
            "description": "An indication of whether the discipline action was taken as a consequence of a zero-tolerance policy violation."
          },
          "receivedEducationServicesDuringExpulsion": {
            "type": "boolean",
            "description": "An indication of whether the student received educational services when removed from the regular school program for disciplinary reasons."
          },
          "disciplines": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disciplineDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of discipline applied (e.g., In School Suspension, Out of School Suspension, Expulsion)."
                }
              },
              "required": [
                "disciplineDescriptor"
              ]
            },
            "description": "The type of discipline (e.g., in-school suspension, out-of-school suspension) associated with a discipline action. Collection child of DisciplineAction. Items unique by (disciplineDescriptor)."
          },
          "staffs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "staffSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster user sourcedId identifying the staff member associated with this discipline action. References `oneroster:user.sourcedId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                }
              },
              "required": [
                "staffSourcedId"
              ]
            },
            "description": "A staff member associated with a discipline action. Collection child of DisciplineAction, keyed on (tenant, disciplineActionIdentifier, studentSourcedId, assignedSchoolSourcedId, disciplineDate, staffSourcedId). Items unique by (staffSourcedId)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this discipline action record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "disciplineActionIdentifier",
          "studentSourcedId",
          "assignedSchoolSourcedId",
          "disciplineDate",
          "recordState",
          "updatedAt"
        ]
      },
      "DisciplineIncident": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, incidentIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify each specific DisciplineIncident."
          },
          "incidentDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the DisciplineIncident occurred."
          },
          "incidentTime": {
            "type": "string",
            "maxLength": 15,
            "description": "An indication of the time of day the incident took place."
          },
          "reporterDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Identifies the reporter of the discipline incident by use of a pre-existing enumeration value."
          },
          "reporterName": {
            "type": "string",
            "maxLength": 75,
            "description": "Identifies the reporter of the discipline incident by name."
          },
          "incidentLocationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Identifies where the DisciplineIncident occurred and whether it occurred on or off campus."
          },
          "staffSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member who reported the incident.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "caseNumber": {
            "type": "string",
            "maxLength": 20,
            "description": "The case number assigned to the DisciplineIncident by law enforcement or other agency."
          },
          "behaviors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "behaviorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Describes behavior by category and provides a detailed description."
                },
                "behaviorDetailedDescription": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "A detailed description of the specific behavior."
                }
              },
              "required": [
                "behaviorDescriptor"
              ]
            },
            "description": "A behavior associated with a discipline incident. Collection child of DisciplineIncident, keyed on (tenant, schoolSourcedId, incidentIdentifier, behaviorDescriptor). Items unique by (behaviorDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this discipline incident record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "incidentIdentifier",
          "incidentDate",
          "recordState",
          "updatedAt"
        ]
      },
      "EdfiDraftRecord": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable unique identifier for this draft record.",
            "readOnly": true
          },
          "resourceType": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The Ed-Fi resource type this draft represents (e.g. `studentSchoolAssociation`, `calendarDate`)."
          },
          "payload": {
            "type": "object",
            "description": "The full JSON payload of the draft resource, stored as-is before any validation or canonicalization."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this draft record. Only `draft` records are eligible for promotion.",
            "default": "draft"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this draft is deleted: `api` for user-initiated DELETE, `import` for removal during a bulk import, `correction` for administrative data correction, `retention_policy` for automated retention sweeps."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed row-creation timestamp (RFC 3339). Read-only — never accepted on create or update."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "id",
          "resourceType",
          "payload",
          "recordState",
          "createdAt",
          "updatedAt"
        ]
      },
      "EducationContent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, contentIdentifier).",
            "readOnly": true
          },
          "contentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 225,
            "description": "A unique identifier for the education content."
          },
          "learningResourceMetadataURI": {
            "type": "string",
            "maxLength": 255,
            "description": "The URI (typical combinator is a URL) pointing to the metadata entry in a LRMI metadata registry."
          },
          "shortDescription": {
            "type": "string",
            "maxLength": 75,
            "description": "A short description or name of the entity."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "An extended written representation of the education content."
          },
          "namespace": {
            "type": "string",
            "maxLength": 255,
            "description": "Namespace for the education content."
          },
          "publicationDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which this content was first published."
          },
          "publicationYear": {
            "type": "integer",
            "description": "The year at which this content was first published."
          },
          "publisher": {
            "type": "string",
            "maxLength": 50,
            "description": "The organization credited with publishing the resource."
          },
          "version": {
            "type": "string",
            "maxLength": 10,
            "description": "The version identifier for the content."
          },
          "timeRequired": {
            "type": "string",
            "maxLength": 30,
            "description": "Approximate or typical time it takes to work with or through this learning resource for the typical intended target audience."
          },
          "cost": {
            "type": "number",
            "description": "An amount that has to be paid or spent to buy or obtain the education content."
          },
          "costRate": {
            "type": "string",
            "maxLength": 306,
            "description": "The rate by which the cost applies (e.g., per student, per year)."
          },
          "interactivityStyle": {
            "type": "string",
            "maxLength": 306,
            "description": "The predominate mode of learning supported by the learning resource (e.g., active, expositive, mixed)."
          },
          "contentClass": {
            "type": "string",
            "maxLength": 306,
            "description": "The predominate type or kind characterizing the learning resource (e.g., presentation, handout, simulation)."
          },
          "useRightsURL": {
            "type": "string",
            "maxLength": 255,
            "description": "The URL where the owner specifies permissions for using the resource."
          },
          "appropriateGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which the education content is appropriate."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level for which an education content item is appropriate, discriminated by grade level descriptor. Collection child of EducationContent. Items unique by (gradeLevelDescriptor)."
          },
          "appropriateSexes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sexDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The sex for which the education content is appropriate."
                }
              },
              "required": [
                "sexDescriptor"
              ]
            },
            "description": "A sex for which an education content item is deemed appropriate, discriminated by sex descriptor. Collection child of EducationContent. Items unique by (sexDescriptor)."
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "author": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "The individual credited with the creation of the resource."
                }
              },
              "required": [
                "author"
              ]
            },
            "description": "An author attributed to an education content item, identified by author name. Collection child of EducationContent. Items unique by (author)."
          },
          "derivativeSourceEducationContents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "derivativeContentIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 225,
                  "description": "The content identifier of the source education content from which this content is derived."
                }
              },
              "required": [
                "derivativeContentIdentifier"
              ]
            },
            "description": "A reference to another education content item from which this content was derived, identified by derivative content identifier. Collection child of EducationContent. Items unique by (derivativeContentIdentifier)."
          },
          "derivativeSourceLearningResourceMetadataURIs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "derivativeLearningResourceMetadataURI": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The URI pointing to the LRMI metadata entry of the source learning resource."
                }
              },
              "required": [
                "derivativeLearningResourceMetadataURI"
              ]
            },
            "description": "A learning resource metadata URI from which an education content item was derived. Collection child of EducationContent. Items unique by (derivativeLearningResourceMetadataURI)."
          },
          "derivativeSourceURIs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "derivativeSourceURI": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The URI of the source from which this education content is derived."
                }
              },
              "required": [
                "derivativeSourceURI"
              ]
            },
            "description": "A generic URI from which an education content item was derived. Collection child of EducationContent. Items unique by (derivativeSourceURI)."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The language in which the education content is available."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language in which an education content item is available, discriminated by language descriptor. Collection child of EducationContent. Items unique by (languageDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "contentIdentifier",
          "recordState",
          "updatedAt"
        ]
      },
      "EducationOrganization": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full, legally accepted name of the institution."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 75,
            "description": "A short name for the institution."
          },
          "webSite": {
            "type": "string",
            "maxLength": 255,
            "description": "The public web site address (URL) for the education organization."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The current operational status of the education organization."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Education organization category."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ],
              "description": "categoriesItem value."
            },
            "description": "Education organization category classifications. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Physical or mailing addresses. Items unique by address natural key."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of institution telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "institutionTelephonesItem value."
            },
            "description": "Institution telephone numbers."
          },
          "indicators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "indicatorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicator type."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Who designated the indicator."
                },
                "indicatorValue": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "indicatorLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Indicator level."
                },
                "indicatorGroupDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Indicator group."
                }
              },
              "required": [
                "indicatorDescriptor"
              ],
              "description": "indicatorsItem value."
            },
            "description": "Education organization indicators/metrics."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "nameOfInstitution",
          "categories",
          "recordState",
          "updatedAt"
        ]
      },
      "EducationOrganizationIdentificationCode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, educationOrganizationSourcedIdentificationSystemDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization this identification code belongs to. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "educationOrganizationIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme used for identification and record-keeping."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an education organization."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The organization code or name assigning the identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "educationOrganizationIdentificationSystemDescriptor",
          "identificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "EducationOrganizationInterventionPrescriptionAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, interventionPrescriptionEducationOrganizationId, interventionPrescriptionIdentificationCode).",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization making the intervention prescription available to its hierarchy.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "interventionPrescriptionEducationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Education organization that defined the intervention prescription (interventionPrescription natural-key leg).",
            "x-references": "interventionPrescription.educationOrganizationId",
            "x-references-legs": [
              "interventionPrescriptionIdentificationCode"
            ],
            "x-onDelete": "restrict"
          },
          "interventionPrescriptionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Identification code of the intervention prescription."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the period during which the intervention prescription is available."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the period during which the intervention prescription is available."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "interventionPrescriptionEducationOrganizationId",
          "interventionPrescriptionIdentificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "EducationOrganizationNetwork": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationNetworkId). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationNetworkId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The unique identifier for this education organization network within the tenant."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the education organization network."
          },
          "networkPurposeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The purpose of the network (e.g. Shared Services, Student Achievement). References the NetworkPurposeDescriptor governed value."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the network's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with an education organization network. A network may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this network. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for an education organization network. A network may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an education organization network by an external system. A network may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for an education organization network, classified by type (e.g. Main, Fax). A network may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this education organization network record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationNetworkId",
          "nameOfInstitution",
          "networkPurposeDescriptor",
          "updatedAt"
        ]
      },
      "EducationOrganizationNetworkAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationNetworkId, memberEducationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationNetworkId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization network.",
            "x-references": "educationOrganizationNetwork.educationOrganizationNetworkId",
            "x-onDelete": "cascade"
          },
          "memberEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The member education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the education organization joined this network."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the education organization left this network."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationNetworkId",
          "memberEducationOrganizationSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "EducationOrganizationPeerAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, peerEducationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "peerEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The peer education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "peerEducationOrganizationSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "EducationServiceCenter": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationServiceCenterId). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationServiceCenterId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The unique identifier for this education service center within the tenant."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the education service center."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the education service center's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with an education service center. An ESC may have multiple addresses differentiated by address type (e.g. Physical, Mailing). The composite natural key includes the address type and core location fields to allow multiple addresses per ESC. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this education service center. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for an education service center. An ESC may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an education service center by an external system (e.g. NCES, state education agency). An ESC may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for an education service center, classified by type (e.g. Main, Fax). An ESC may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this education service center record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationServiceCenterId",
          "nameOfInstitution",
          "updatedAt"
        ]
      },
      "EducatorPreparationProgram": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, programName, programTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that operates the program.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The formal name of the educator preparation program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of educator preparation program."
          },
          "programId": {
            "type": "string",
            "maxLength": 20,
            "description": "A unique code assigned to the program."
          },
          "accreditationStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Accreditation status of the program."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Associated grade levels."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "Evaluation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent performance evaluation.",
            "x-references": "performanceEvaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "Evaluation description."
          },
          "minNumericRating": {
            "type": "number",
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": "number",
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "interRaterReliabilityScore": {
            "type": "integer",
            "description": "Inter-rater reliability score."
          },
          "ratingLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "EvaluationElement": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationObjectiveTitle, evaluationElementTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation objective.",
            "x-references": "evaluationObjective.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "sortOrder": {
            "type": "integer",
            "description": "Sort order."
          },
          "minNumericRating": {
            "type": "number",
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": "number",
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "ratingLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "EvaluationElementRating": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationDate, evaluationObjectiveTitle, evaluationElementTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation objective rating.",
            "x-references": "evaluationObjectiveRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "evaluationElementRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Element rating level."
          },
          "areaOfRefinement": {
            "type": "string",
            "maxLength": 1024,
            "description": "Area of refinement."
          },
          "areaOfReinforcement": {
            "type": "string",
            "maxLength": 1024,
            "description": "Area of reinforcement."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "feedback": {
            "type": "string",
            "maxLength": 2048,
            "description": "Feedback."
          },
          "elementRatingResults": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "EvaluationObjective": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationObjectiveTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation.",
            "x-references": "evaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationObjectiveDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "Evaluation objective description."
          },
          "sortOrder": {
            "type": "integer",
            "description": "Sort order."
          },
          "minNumericRating": {
            "type": "number",
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": "number",
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "ratingLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationObjectiveTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "EvaluationObjectiveRating": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationDate, evaluationObjectiveTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation rating.",
            "x-references": "evaluationRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "objectiveRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Objective rating level."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "objectiveRatingResults": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "evaluationObjectiveTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "EvaluationRating": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent performance evaluation rating.",
            "x-references": "performanceEvaluationRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Date/time of the evaluation rating."
          },
          "evaluationRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Rating level."
          },
          "evaluationRatingStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Rating status."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "actualDuration": {
            "type": "integer",
            "description": "Actual duration in minutes."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional school of an associated section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Optional section local course code."
          },
          "sectionSchoolYear": {
            "type": "integer",
            "description": "Optional section school year."
          },
          "sectionSessionName": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional section session name."
          },
          "sectionIdentifier": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional section identifier."
          },
          "reviewers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Reviewer middle name."
                },
                "reviewerPersonId": {
                  "type": "string",
                  "maxLength": 32,
                  "description": "Optional personId of the reviewer."
                },
                "reviewerSourceSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Optional source system of the reviewer person."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Reviewers associated with this rating."
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "recordState",
          "updatedAt"
        ]
      },
      "EvaluationRubricDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationId, programName, programTypeDescriptor, programEvaluationTitle, programEvaluationPeriodDescriptor, programEvaluationTypeDescriptor, programEvaluationElementTitle, evaluationRubricRating). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program evaluation element.",
            "x-references": "programEvaluationElement.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor",
              "programEvaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Parent program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent program type."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Parent program evaluation title."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent evaluation period."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent evaluation type."
          },
          "programEvaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Parent program evaluation element title."
          },
          "evaluationRubricRating": {
            "type": "integer",
            "description": "The rubric rating value for this dimension."
          },
          "evaluationCriterionDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Description of the evaluation criterion."
          },
          "evaluationRubricRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Rating level for this rubric dimension."
          },
          "rubricDimensionSortOrder": {
            "type": "integer",
            "description": "Sort order of the rubric dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "programEvaluationElementTitle",
          "evaluationRubricRating",
          "evaluationCriterionDescription",
          "recordState",
          "updatedAt"
        ]
      },
      "ExportJob": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable unique identifier for this export job.",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "in_progress",
              "completed",
              "failed"
            ],
            "description": "Current processing status of the export job."
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when the export job began processing."
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when the export job finished. Null while in progress."
          },
          "format": {
            "type": "string",
            "enum": [
              "json",
              "csv",
              "parquet"
            ],
            "description": "Output format for the exported data."
          },
          "privacyLevel": {
            "type": "string",
            "enum": [
              "full",
              "redacted",
              "anonymized"
            ],
            "description": "Privacy/redaction tier applied to the export. `full` includes all fields, `redacted` strips PII, `anonymized` additionally hashes identifiers."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed row-creation timestamp (RFC 3339). Read-only — never accepted on create or update."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "id",
          "status",
          "startedAt",
          "format",
          "privacyLevel",
          "createdAt",
          "updatedAt"
        ]
      },
      "FeederSchoolAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "feederSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The feeder school organization. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The receiving school organization. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the feeder relationship became effective."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the feeder relationship ended, if applicable."
          },
          "feederRelationshipDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "A description of the feeder relationship between the schools."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this feeder school association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "feederSchoolSourcedId",
          "schoolSourcedId",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "FieldworkExperience": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, fieldworkIdentifier, studentSourcedId, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "fieldworkIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "A unique identifier for the fieldwork experience."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Fieldwork begin date."
          },
          "fieldworkTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type of fieldwork."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Fieldwork end date."
          },
          "hoursCompleted": {
            "type": "number",
            "description": "Hours completed."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional school.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional EPP education organization.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional EPP program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional EPP program type."
          },
          "coteaching": {
            "type": "object",
            "properties": {
              "coteachingBeginDate": {
                "type": "string",
                "format": "date",
                "description": "Coteaching begin date."
              },
              "coteachingEndDate": {
                "type": "string",
                "format": "date",
                "description": "Coteaching end date."
              }
            },
            "required": [
              "coteachingBeginDate"
            ],
            "description": "Coteaching details."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "fieldworkIdentifier",
          "studentSourcedId",
          "fieldworkTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "FieldworkExperienceSectionAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, fieldworkIdentifier, studentSourcedId, beginDate, schoolSourcedId, localCourseCode, schoolYear, sessionName, sectionIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "fieldworkIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Fieldwork experience identifier.",
            "x-references": "fieldworkExperience.fieldworkIdentifier",
            "x-references-legs": [
              "studentSourcedId",
              "beginDate"
            ],
            "x-onDelete": "cascade"
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the fieldwork experience."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Begin date of the fieldwork experience."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Local course code of the section."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year of the section."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Session name of the section."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Section identifier."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "fieldworkIdentifier",
          "studentSourcedId",
          "beginDate",
          "schoolSourcedId",
          "localCourseCode",
          "schoolYear",
          "sessionName",
          "sectionIdentifier",
          "recordState",
          "updatedAt"
        ]
      },
      "FinancialAid": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, beginDate, aidTypeDescriptor).",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student receiving aid.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the award was designated."
          },
          "aidTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The classification of financial aid awarded to a person for the academic term/year."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the award was removed."
          },
          "aidConditionDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "The description of the condition under which the aid was given."
          },
          "aidAmount": {
            "type": "number",
            "description": "The amount of financial aid awarded to a person for the term/year."
          },
          "pellGrantRecipient": {
            "type": "boolean",
            "description": "Indicates a person who receives Pell Grant aid."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "beginDate",
          "aidTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "FunctionDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, code, fiscalYear). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "code",
          "fiscalYear",
          "recordState",
          "updatedAt"
        ]
      },
      "FundDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, code, fiscalYear). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "code",
          "fiscalYear",
          "recordState",
          "updatedAt"
        ]
      },
      "GeneralStudentProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for `{id}` wire routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student participating in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (e.g., Title I Part A, Special Education, Bilingual/ESL)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program. Typically, this is the date the student becomes eligible for the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "GeneralStudentProgramAssociationProgramParticipationStatus": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate, participationStatusDescriptor, statusBeginDate).",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student sourcedId forming the first column of the composite FK back to the parent generalStudentProgramAssociation.",
            "x-references": "generalStudentProgramAssociation.studentSourcedId",
            "x-references-legs": [
              "programEducationOrganizationSourcedId",
              "programName",
              "programTypeDescriptor",
              "beginDate"
            ],
            "x-onDelete": "cascade"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The program education organization sourcedId forming part of the composite FK back to the parent."
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The program name forming part of the composite FK back to the parent."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The program type descriptor forming part of the composite FK back to the parent."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date forming part of the composite FK back to the parent (the parent's program beginDate)."
          },
          "participationStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The student's program participation status (e.g., Active, Completed, Withdrawn)."
          },
          "statusBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the participation status became effective."
          },
          "statusEndDate": {
            "type": "string",
            "format": "date",
            "description": "The date the participation status ended."
          },
          "designatedBy": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The person, organization, or department that designated the participation status."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "participationStatusDescriptor",
          "statusBeginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "Goal": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor, goalTitle, assignmentDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person the goal is assigned to.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "goalTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Goal title."
          },
          "assignmentDate": {
            "type": "string",
            "format": "date",
            "description": "Date the goal was assigned."
          },
          "goalTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Goal type."
          },
          "goalDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Goal description."
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "description": "Due date."
          },
          "completedIndicator": {
            "type": "boolean",
            "description": "Whether the goal is completed."
          },
          "completedDate": {
            "type": "string",
            "format": "date",
            "description": "Completed date."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional education organization for linked evaluation construct."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "maxLength": 50,
            "description": "Optional performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "Optional school year."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional term."
          },
          "evaluationTitle": {
            "type": "string",
            "maxLength": 50,
            "description": "Optional evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "maxLength": 50,
            "description": "Optional evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional evaluation element title."
          },
          "parentGoalTitle": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional parent goal title (self-ref; command-layer)."
          },
          "parentGoalAssignmentDate": {
            "type": "string",
            "format": "date",
            "description": "Optional parent goal assignment date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "goalTitle",
          "assignmentDate",
          "recordState",
          "updatedAt"
        ]
      },
      "Grade": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student receiving the grade.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the grade was earned.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to the section."
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grading period for which the grade is recorded."
          },
          "periodSequence": {
            "type": "integer",
            "description": "The sequential order of this grading period within the school year."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the student's entry or assignment to the section."
          },
          "gradeTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of grade (e.g., Exam, Final, Grading Period)."
          },
          "letterGradeEarned": {
            "type": "string",
            "maxLength": 20,
            "description": "A final or interim letter grade earned for the grading period."
          },
          "numericGradeEarned": {
            "type": "number",
            "description": "A final or interim numeric grade earned."
          },
          "diagnosticStatement": {
            "type": "string",
            "maxLength": 1024,
            "description": "A statement of the grade's diagnostic meaning or context."
          },
          "performanceBaseConversionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Performance base conversion descriptor."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this grade record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "localCourseCode",
          "schoolYear",
          "termDescriptor",
          "sectionIdentifier",
          "gradingPeriodDescriptor",
          "periodSequence",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "GradebookEntry": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, gradebookEntryIdentifier, namespace). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "gradebookEntryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to a gradebook entry by the source system."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace URI for the source of the gradebook entry."
          },
          "sourceSectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to a section (source system section id)."
          },
          "dateAssigned": {
            "type": "string",
            "format": "date",
            "description": "The date the assignment was assigned or executed."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name or title of the activity."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "A description of the assignment."
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "description": "The date the assignment is due."
          },
          "dueTime": {
            "type": "string",
            "format": "time",
            "description": "The time the assignment is due."
          },
          "gradebookEntryTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of the gradebook entry."
          },
          "maxPoints": {
            "type": "number",
            "description": "The maximum number of points that can be earned."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional school of the associated section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Optional local course code of the associated section."
          },
          "schoolYear": {
            "type": "integer",
            "description": "Optional school year of the associated section."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional term of the associated section."
          },
          "sectionIdentifier": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional section identifier of the associated section."
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional grading period descriptor."
          },
          "gradingPeriodSequence": {
            "type": "integer",
            "description": "Optional grading period sequence."
          },
          "gradingPeriodSchoolYear": {
            "type": "integer",
            "description": "Optional grading period school year."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Learning standard id."
                }
              },
              "required": [
                "learningStandardId"
              ],
              "description": "learningStandardsItem value."
            },
            "description": "Learning standards associated with the gradebook entry."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "gradebookEntryIdentifier",
          "namespace",
          "sourceSectionIdentifier",
          "dateAssigned",
          "title",
          "recordState",
          "updatedAt"
        ]
      },
      "GradingPeriod": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, gradingPeriodDescriptor, periodSequence, schoolYear). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this grading period belongs to. Establishes the cross-module FK into OneRoster.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of grading period (e.g. First Six Weeks, Second Semester, End of Year). References the GradingPeriodDescriptor governed value."
          },
          "periodSequence": {
            "type": "integer",
            "minimum": 1,
            "description": "The sequential order of this grading period within the school year."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year to which this grading period belongs."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The first calendar date of the grading period."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The last calendar date of the grading period."
          },
          "totalInstructionalDays": {
            "type": "integer",
            "minimum": 0,
            "description": "The total number of instructional days in the grading period."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this grading period record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "gradingPeriodDescriptor",
          "periodSequence",
          "schoolYear",
          "beginDate",
          "endDate",
          "updatedAt"
        ]
      },
      "GraduationPlan": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this graduation plan."
          },
          "graduationPlanTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of graduation plan (e.g., Recommended, Distinguished, Minimum)."
          },
          "graduationSchoolYear": {
            "type": "integer",
            "description": "The school year the student is expected to graduate."
          },
          "totalRequiredCredits": {
            "type": "number",
            "description": "The total number of credits required for graduation."
          },
          "totalRequiredCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credits required."
          },
          "individualPlan": {
            "type": "boolean",
            "description": "An indicator of whether the graduation plan is tailored for an individual."
          },
          "requiredCredits": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "creditCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of credit required (e.g., Mathematics, English, Science)."
                },
                "credits": {
                  "type": "number",
                  "description": "The number of credits required in this category."
                },
                "creditTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of credits (e.g., Carnegie unit)."
                }
              },
              "required": [
                "creditCategoryDescriptor",
                "credits"
              ]
            },
            "description": "A credit requirement within a graduation plan, keyed by credit category. Collection child of GraduationPlan. Items unique by (creditCategoryDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this graduation plan record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "graduationPlanTypeDescriptor",
          "graduationSchoolYear",
          "recordState",
          "updatedAt"
        ]
      },
      "IdeaEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, ideaEventIdentifier, ideaEventTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "ideaEventIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the IDEA event."
          },
          "ideaEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of IDEA event."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the IDEA event."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the IDEA event."
          },
          "eventComplianceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Whether the event was compliant."
          },
          "eventNarrative": {
            "type": "string",
            "maxLength": 2048,
            "description": "Narrative description of the event."
          },
          "eventReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason for the IDEA event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "ideaEventIdentifier",
          "ideaEventTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "ImportJob": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable unique identifier for this import job.",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "in_progress",
              "completed",
              "failed"
            ],
            "description": "Current processing status of the import job."
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when the import job began processing."
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when the import job finished processing. Null while in progress."
          },
          "totalRows": {
            "type": "integer",
            "minimum": 0,
            "description": "Total number of rows submitted in this import batch."
          },
          "successCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of rows that were successfully imported or updated."
          },
          "failureCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of rows that failed validation or import."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed row-creation timestamp (RFC 3339). Read-only — never accepted on create or update."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "id",
          "status",
          "startedAt",
          "totalRows",
          "successCount",
          "failureCount",
          "createdAt",
          "updatedAt"
        ]
      },
      "ImportRow": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Stable unique identifier for this import row record.",
            "readOnly": true
          },
          "importJobId": {
            "type": "string",
            "format": "uuid",
            "description": "The import job this row belongs to.",
            "x-references": "importJob.id",
            "x-onDelete": "cascade"
          },
          "rowIndex": {
            "type": "integer",
            "minimum": 0,
            "description": "Zero-based positional index of this row within the import batch."
          },
          "resourceType": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The Ed-Fi resource type this row represents (e.g. `student`, `calendarDate`)."
          },
          "payload": {
            "type": "object",
            "description": "The raw JSON payload submitted for this row."
          },
          "validationErrors": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Array of validation error objects if this row failed roster-boundary, descriptor-governance, or schema validation. Empty or absent for successful rows."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Outcome state for this row: `canonical` if successfully imported, `rejected` if validation failed."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed row-creation timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "id",
          "importJobId",
          "rowIndex",
          "resourceType",
          "payload",
          "recordState",
          "createdAt"
        ]
      },
      "Intervention": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The start date for the intervention implementation."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date for the intervention implementation."
          },
          "maxDosage": {
            "type": "integer",
            "description": "The maximum duration of time in minutes that may be assigned for the intervention."
          },
          "minDosage": {
            "type": "integer",
            "description": "The minimum duration of time in minutes that may be assigned for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "interventionIdentificationCode",
          "interventionClassDescriptor",
          "deliveryMethodDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "InterventionPrescription": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this intervention prescription."
          },
          "interventionPrescriptionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention prescription."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "maxDosage": {
            "type": "integer",
            "description": "The maximum duration of time in minutes that may be assigned for the intervention."
          },
          "minDosage": {
            "type": "integer",
            "description": "The minimum duration of time in minutes that may be assigned for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention prescription record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "interventionPrescriptionIdentificationCode",
          "interventionClassDescriptor",
          "deliveryMethodDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "InterventionStudy": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that conducted or commissioned this intervention study."
          },
          "interventionStudyIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention study."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "participants": {
            "type": "integer",
            "description": "The number of participants in the intervention study."
          },
          "interventionEffectivenessRatingDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indicator of the overall effectiveness rating for the intervention study."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention study record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "interventionStudyIdentificationCode",
          "interventionClassDescriptor",
          "deliveryMethodDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "LearningStandard": {
        "type": "object",
        "properties": {
          "identifier": {
            "type": "string",
            "format": "uuid",
            "description": "The CASE CFItem identifier (composite-natural PK). Required on create; also the Ed-Fi detail-route key under multi-base (joined learningStandardId cannot back a projection derivedHash)."
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "description": "The text of the statement (CASE fullStatement). Shared field — UPDATE requires edfi:write-shared."
          },
          "uri": {
            "type": "string",
            "format": "uri",
            "description": "An unambiguous reference to the statement using a network-resolvable URI (CASE uri). Shared field — UPDATE requires edfi:write-shared."
          },
          "learningStandardItemCode": {
            "type": "string",
            "minLength": 1,
            "description": "A code designated by the promulgating body to identify the statement (CASE humanCodingScheme). Shared field — UPDATE requires edfi:write-shared."
          },
          "learningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a Learning Standard. Ed-Fi-owned extends field; source of the derived-hash GUID."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the organization or entity who governs the standard (e.g., uri://ed-fi.org)."
          },
          "courseTitle": {
            "type": "string",
            "maxLength": 60,
            "description": "The official course title with which this learning standard is associated."
          },
          "successCriteria": {
            "type": "string",
            "maxLength": 150,
            "description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a learning standard."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area (e.g., Mathematics, Science, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject area associated with a learning standard. Items unique by (academicSubjectDescriptor)."
          },
          "contentStandard": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 75,
                "description": "The name of the content standard (e.g., Texas Essential Knowledge and Skills)."
              },
              "uri": {
                "type": "string",
                "maxLength": 255,
                "description": "An unambiguous reference to the standards using a network-resolvable URI."
              },
              "publicationDate": {
                "type": "string",
                "format": "date",
                "description": "The date on which this content was first published."
              },
              "publicationYear": {
                "type": "integer",
                "description": "The year at which this content was first published."
              },
              "version": {
                "type": "string",
                "maxLength": 50,
                "description": "The version identifier for the content."
              },
              "mandatingEducationOrganizationId": {
                "type": "string",
                "maxLength": 255,
                "description": "The identifier of the education organization that mandated this content standard."
              },
              "authors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "author": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "description": "The name of an individual who authored the content standard."
                    }
                  },
                  "required": [
                    "author"
                  ]
                },
                "description": "An author of the content standard associated with a learning standard. Items unique by (author)."
              }
            },
            "description": "Content standard metadata associated with a learning standard (1:1 singleton child)."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which the learning standard is designated (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level associated with a learning standard, indicating the intended audience level. Items unique by (gradeLevelDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to a learning standard by a content standard body."
                },
                "contentStandardName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 65,
                  "description": "The name of the content standard (e.g., Texas Essential Knowledge and Skills, Common Core State Standards)."
                }
              },
              "required": [
                "identificationCode",
                "contentStandardName"
              ]
            },
            "description": "An identification code assigned to a learning standard by a content standard body. Items unique by (identificationCode, contentStandardName)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this learning standard record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed row-creation timestamp (RFC 3339). Read-only — never accepted on create or update."
          },
          "lastChangeDateTime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "identifier",
          "description",
          "uri",
          "learningStandardId",
          "namespace",
          "recordState",
          "createdAt",
          "lastChangeDateTime"
        ]
      },
      "LearningStandardEquivalenceAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, sourceLearningStandardId, targetLearningStandardId).",
            "readOnly": true
          },
          "sourceLearningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The source learning standard in the equivalence relationship, matching edfi:learningStandard.learningStandardId. Not a DB-level FK (learningStandard is now a projection of case:cfItem, and its natural key is an extends field, not the master's uuid identifier); validated at the command layer."
          },
          "targetLearningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The target learning standard in the equivalence relationship, matching edfi:learningStandard.learningStandardId. Not a DB-level FK (see sourceLearningStandardId); validated at the command layer."
          },
          "effectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The date from which the equivalence association is effective."
          },
          "equivalenceStrengthDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "A free-text description of the equivalence strength between the source and target standards."
          },
          "equivalenceStrengthDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "A descriptor indicating the strength of the equivalence (e.g., Strong, Moderate, Weak)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "sourceLearningStandardId",
          "targetLearningStandardId",
          "recordState",
          "updatedAt"
        ]
      },
      "LearningStandardExtension": {
        "type": "object",
        "properties": {
          "cfItemIdentifier": {
            "type": "string",
            "format": "uuid",
            "description": "Shared natural id with the CASE CFItem this learning standard extends 1:1. FK CASCADE so deleting the CFItem reaps the companion.",
            "x-references": "case:cfItem.identifier",
            "x-onDelete": "cascade"
          },
          "learningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a Learning Standard."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the organization or entity who governs the standard (e.g., uri://ed-fi.org)."
          },
          "courseTitle": {
            "type": "string",
            "maxLength": 60,
            "description": "The official course title with which this learning standard is associated."
          },
          "successCriteria": {
            "type": "string",
            "maxLength": 150,
            "description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a learning standard."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area (e.g., Mathematics, Science, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject area associated with a learning standard. Items unique by (academicSubjectDescriptor)."
          },
          "contentStandard": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 75,
                "description": "The name of the content standard (e.g., Texas Essential Knowledge and Skills)."
              },
              "uri": {
                "type": "string",
                "maxLength": 255,
                "description": "An unambiguous reference to the standards using a network-resolvable URI."
              },
              "publicationDate": {
                "type": "string",
                "format": "date",
                "description": "The date on which this content was first published."
              },
              "publicationYear": {
                "type": "integer",
                "description": "The year at which this content was first published."
              },
              "version": {
                "type": "string",
                "maxLength": 50,
                "description": "The version identifier for the content."
              },
              "mandatingEducationOrganizationId": {
                "type": "string",
                "maxLength": 255,
                "description": "The identifier of the education organization that mandated this content standard."
              },
              "authors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "author": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "description": "The name of an individual who authored the content standard."
                    }
                  },
                  "required": [
                    "author"
                  ]
                },
                "description": "An author of the content standard associated with a learning standard. Items unique by (author)."
              }
            },
            "description": "Content standard metadata associated with a learning standard (1:1 singleton child)."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which the learning standard is designated (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level associated with a learning standard, indicating the intended audience level. Items unique by (gradeLevelDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to a learning standard by a content standard body."
                },
                "contentStandardName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 65,
                  "description": "The name of the content standard (e.g., Texas Essential Knowledge and Skills, Common Core State Standards)."
                }
              },
              "required": [
                "identificationCode",
                "contentStandardName"
              ]
            },
            "description": "An identification code assigned to a learning standard by a content standard body. Items unique by (identificationCode, contentStandardName)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this learning standard record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        },
        "required": [
          "cfItemIdentifier",
          "learningStandardId",
          "namespace",
          "recordState"
        ]
      },
      "LocalAccount": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization (FK to Account).",
            "x-references": "chartOfAccount.educationOrganizationId",
            "x-references-legs": [
              "accountIdentifier",
              "fiscalYear"
            ],
            "x-onDelete": "soft-cascade"
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the parent account (part of parent FK)."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the parent account is valid (part of parent FK)."
          },
          "accountClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of account code classification (e.g., Fund, Function, Object)."
          },
          "accountCodeNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The number assigned to the account code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "accountClassificationDescriptor",
          "accountCodeNumber",
          "recordState",
          "updatedAt"
        ]
      },
      "LocalActual": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the actual is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported actual amount."
          },
          "amount": {
            "type": "number",
            "description": "The current balance or amount for the financial statement dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amount",
          "recordState",
          "updatedAt"
        ]
      },
      "LocalBudget": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the budget is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported budget amount."
          },
          "amount": {
            "type": "number",
            "description": "The budgeted amount for the account."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amount",
          "recordState",
          "updatedAt"
        ]
      },
      "LocalContractedStaff": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the contracted staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the contracted staff expenditure is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported contracted staff amount."
          },
          "amountToDate": {
            "type": "number",
            "description": "The cumulative amount paid to the contracted staff member to date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amountToDate",
          "recordState",
          "updatedAt"
        ]
      },
      "LocalEducationAgency": {
        "type": "object",
        "properties": {
          "localEducationAgencyId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies this local education agency in the roster layer. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the local education agency (OneRoster org name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "district"
            ],
            "description": "RESTRICTED to the org type \"district\" — only district-rung org rows are visible through this projection."
          },
          "localEducationAgencyCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of local education agency (e.g. Independent, Charter). References the LocalEducationAgencyCategoryDescriptor governed value."
          },
          "charterStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The charter status of the LEA (e.g. School Charter, Open Enrollment Charter, Not a Charter School). References the CharterStatusDescriptor governed value. NOTE: column is namespaced (leaCharterStatusDescriptor) because oneroster:org is also projected by edfi:school, which owns the plain charterStatusDescriptor column; the wire name is unaffected."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the LEA's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a local education agency. An LEA may have multiple addresses differentiated by address type (e.g. Physical, Mailing). Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this LEA (e.g. School District, Education Service Center). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a local education agency. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a local education agency by an external system (e.g. NCES, state education agency). Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax, Attendance line). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a local education agency, classified by type (e.g. Main, Fax, Attendance). Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this LEA record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "localEducationAgencyId",
          "nameOfInstitution",
          "type",
          "localEducationAgencyCategoryDescriptor",
          "dateLastModified"
        ]
      },
      "LocalEducationAgencyExtension": {
        "type": "object",
        "properties": {
          "orgSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Shared natural id with the OneRoster org this local education agency extension belongs to 1:1. FK CASCADE so deleting the org reaps the companion.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "localEducationAgencyCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of local education agency (e.g. Independent, Charter). References the LocalEducationAgencyCategoryDescriptor governed value."
          },
          "charterStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The charter status of the LEA (e.g. School Charter, Open Enrollment Charter, Not a Charter School). References the CharterStatusDescriptor governed value. NOTE: column is namespaced (leaCharterStatusDescriptor) because oneroster:org is also projected by edfi:school, which owns the plain charterStatusDescriptor column; the wire name is unaffected."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the LEA's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a local education agency. An LEA may have multiple addresses differentiated by address type (e.g. Physical, Mailing). Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this LEA (e.g. School District, Education Service Center). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a local education agency. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a local education agency by an external system (e.g. NCES, state education agency). Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax, Attendance line). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a local education agency, classified by type (e.g. Main, Fax, Attendance). Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this LEA record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        },
        "required": [
          "orgSourcedId"
        ]
      },
      "LocalEncumbrance": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationId, accountIdentifier, fiscalYear, asOfDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that owns the account."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the encumbrance is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported encumbrance amount."
          },
          "amount": {
            "type": "number",
            "description": "The encumbered amount for the account."
          },
          "financialCollectionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The financial collection associated with this encumbrance."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amount",
          "recordState",
          "updatedAt"
        ]
      },
      "LocalPayroll": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member receiving payroll.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the payroll is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported payroll amount."
          },
          "amount": {
            "type": "number",
            "description": "The payroll amount for the staff member."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amount",
          "recordState",
          "updatedAt"
        ]
      },
      "Location": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, schoolSourcedId, classroomIdentificationCode). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school that owns this location.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classroomIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to a room by the school."
          },
          "maximumNumberOfSeats": {
            "type": "integer",
            "description": "The maximum number of seats the class can maintain."
          },
          "optimalNumberOfSeats": {
            "type": "integer",
            "description": "The most favorable number of seats for the class."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "classroomIdentificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "ObjectDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, code, fiscalYear). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "code",
          "fiscalYear",
          "recordState",
          "updatedAt"
        ]
      },
      "ObjectiveAssessment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assessmentIdentifier, namespace, identificationCode). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this objective belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an objective assessment."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "A detailed description of the objective assessment."
          },
          "maxRawScore": {
            "type": "number",
            "description": "The maximum raw score achievable on this objective assessment."
          },
          "percentOfAssessment": {
            "type": "number",
            "description": "The percentage of the assessment that tests this objective."
          },
          "nomenclature": {
            "type": "string",
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used."
          },
          "parentIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The identification code of the parent objective assessment, for hierarchical objectives."
          },
          "performanceLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level (e.g., Below Basic, Basic, Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this performance level."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score for this performance level."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score for this performance level."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level definition for an objective assessment. Collection child of ObjectiveAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "scores": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this score (e.g., Scale score, Raw score)."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score possible."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score possible."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A score definition for an objective assessment. Collection child of ObjectiveAssessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this objective assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assessmentIdentifier",
          "namespace",
          "identificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "OpenStaffPosition": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization with the open staff position."
          },
          "requisitionNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "The number or identifier assigned to the open staff position requisition."
          },
          "employmentStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of employment status for the position (e.g., Tenured, Non-tenured, Substitute)."
          },
          "staffClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The staff classification for the position (e.g., Teacher, Principal, Counselor)."
          },
          "datePosted": {
            "type": "string",
            "format": "date",
            "description": "The date the position was posted."
          },
          "datePostingRemoved": {
            "type": "string",
            "format": "date",
            "description": "The date the posting was removed or filled."
          },
          "positionTitle": {
            "type": "string",
            "maxLength": 100,
            "description": "The descriptive title of the position."
          },
          "programAssignmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The program to which the staff position is assigned (e.g., Regular Education, Title I)."
          },
          "postingResultDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The result of the posting (e.g., Position Filled, Position Still Open)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this open staff position record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "requisitionNumber",
          "employmentStatusDescriptor",
          "staffClassificationDescriptor",
          "datePosted",
          "recordState",
          "updatedAt"
        ]
      },
      "OpenStaffPositionEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationId, requisitionNumber, eventDate, openStaffPositionEventTypeDescriptor).",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Education organization of the open staff position (openStaffPosition natural-key leg).",
            "x-references": "openStaffPosition.educationOrganizationId",
            "x-references-legs": [
              "requisitionNumber"
            ],
            "x-onDelete": "restrict"
          },
          "requisitionNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Requisition number of the open staff position."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date when the open staff position event occurred."
          },
          "openStaffPositionEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Specifies the type of milestone event."
          },
          "openStaffPositionEventStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Reflects the status of the milestone event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "requisitionNumber",
          "eventDate",
          "openStaffPositionEventTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "OperationalUnitDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, code, fiscalYear). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "code",
          "fiscalYear",
          "recordState",
          "updatedAt"
        ]
      },
      "OrganizationDepartment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, organizationDepartmentId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "organizationDepartmentId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identification code for the organization department."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full, legally accepted name of the department (EducationOrganization inherited)."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 75,
            "description": "A short name for the department."
          },
          "webSite": {
            "type": "string",
            "maxLength": 255,
            "description": "Public website URL."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Operational status."
          },
          "academicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The intended major subject area of the department."
          },
          "parentEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The parent education organization this department belongs to. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Education organization category."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ],
              "description": "categoriesItem value."
            },
            "description": "Category classifications."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of institution telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "institutionTelephonesItem value."
            },
            "description": "Institution telephones."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "organizationDepartmentId",
          "nameOfInstitution",
          "recordState",
          "updatedAt"
        ]
      },
      "Path": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, pathName). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the path of study. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path of study."
          },
          "graduationPlanEducationOrganizationId": {
            "type": "string",
            "maxLength": 60,
            "description": "Education organization of the optional graduation plan (part of graduationPlan natural key).",
            "x-references": "graduationPlan.educationOrganizationId",
            "x-references-legs": [
              "graduationPlanTypeDescriptor",
              "graduationSchoolYear"
            ],
            "x-onDelete": "restrict"
          },
          "graduationPlanTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Graduation plan type (part of graduationPlan natural key)."
          },
          "graduationSchoolYear": {
            "type": "integer",
            "description": "Graduation school year of the optional graduation plan."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "pathName",
          "recordState",
          "updatedAt"
        ]
      },
      "PathMilestone": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, pathMilestoneName, pathMilestoneTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "pathMilestoneName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path milestone."
          },
          "pathMilestoneTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the path milestone."
          },
          "pathMilestoneCode": {
            "type": "string",
            "maxLength": 60,
            "description": "A code for the path milestone."
          },
          "pathMilestoneDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Description of the path milestone."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "pathMilestoneName",
          "pathMilestoneTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "PathPhase": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, pathName, pathPhaseName). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent path. Roster FK; part of Path natural key.",
            "x-references": "path.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Name of the parent path."
          },
          "pathPhaseName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path phase."
          },
          "pathPhaseSequence": {
            "type": "integer",
            "description": "Sequence order of the phase within the path."
          },
          "phasePathDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Description of the path phase."
          },
          "pathMilestones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "pathMilestoneName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Referenced path milestone name."
                },
                "pathMilestoneTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Referenced path milestone type."
                }
              },
              "required": [
                "pathMilestoneName",
                "pathMilestoneTypeDescriptor"
              ],
              "description": "pathMilestonesItem value."
            },
            "description": "Path milestones associated with this phase (folded join collection)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "pathName",
          "pathPhaseName",
          "recordState",
          "updatedAt"
        ]
      },
      "PerformanceEvaluation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the performance evaluation.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "performanceEvaluationDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "Description of the performance evaluation."
          },
          "academicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Academic subject."
          },
          "ratingLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Associated grade levels."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "PerformanceEvaluationRating": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person being evaluated.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the performance evaluation.",
            "x-references": "performanceEvaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "actualDate": {
            "type": "string",
            "format": "date",
            "description": "Actual date of the rating."
          },
          "announced": {
            "type": "boolean",
            "description": "Whether the evaluation was announced."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "coteachingStyleObservedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Coteaching style observed."
          },
          "actualDuration": {
            "type": "integer",
            "description": "Actual duration in minutes."
          },
          "performanceEvaluationRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Overall rating level."
          },
          "scheduleDate": {
            "type": "string",
            "format": "date",
            "description": "Scheduled date."
          },
          "actualTime": {
            "type": "string",
            "format": "time",
            "description": "Actual time."
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "reviewers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Reviewer middle name."
                },
                "reviewerPersonId": {
                  "type": "string",
                  "maxLength": 32,
                  "description": "Optional personId of the reviewer."
                },
                "reviewerSourceSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Optional source system of the reviewer person."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Reviewers associated with this rating."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "actualDate",
          "recordState",
          "updatedAt"
        ]
      },
      "Person": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a person."
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The originating record source system for the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "PostSecondaryEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with this post-secondary event. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "postSecondaryEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of post-secondary event (e.g., College Application, College Acceptance, College Enrollment)."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date the post-secondary event occurred."
          },
          "postSecondaryInstitutionId": {
            "type": "string",
            "maxLength": 60,
            "description": "The identifier of the post-secondary institution associated with this event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this post-secondary event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "postSecondaryEventCategoryDescriptor",
          "eventDate",
          "recordState",
          "updatedAt"
        ]
      },
      "PostSecondaryInstitution": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, postSecondaryInstitutionId). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "postSecondaryInstitutionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The unique identifier for this post-secondary institution within the tenant."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the post-secondary institution."
          },
          "postSecondaryInstitutionLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The level of the institution (e.g. Four-year, Two-year, Less Than Two-year). References the PostSecondaryInstitutionLevelDescriptor governed value."
          },
          "administrativeFundingControlDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The administrative funding control classification (e.g. Public, Private Nonprofit, Proprietary). References the AdministrativeFundingControlDescriptor governed value."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the institution's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a post-secondary institution. An institution may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this institution. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a post-secondary institution. An institution may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a post-secondary institution by an external system (e.g. IPEDS, NCES). An institution may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Admissions, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a post-secondary institution, classified by type (e.g. Main, Admissions, Fax). An institution may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this post-secondary institution record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "postSecondaryInstitutionId",
          "nameOfInstitution",
          "updatedAt"
        ]
      },
      "ProfessionalDevelopmentEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, professionalDevelopmentTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the professional development event."
          },
          "professionalDevelopmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Title of the professional development event."
          },
          "professionalDevelopmentOfferedByDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Who offered the professional development."
          },
          "totalHours": {
            "type": "integer",
            "description": "Total hours of the event."
          },
          "required": {
            "type": "boolean",
            "description": "Whether attendance is required."
          },
          "multipleSession": {
            "type": "boolean",
            "description": "Whether the event has multiple sessions."
          },
          "professionalDevelopmentReason": {
            "type": "string",
            "maxLength": 60,
            "description": "Reason for the professional development."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "professionalDevelopmentTitle",
          "professionalDevelopmentOfferedByDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "ProfessionalDevelopmentEventAttendance": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor, namespace, professionalDevelopmentTitle, attendanceDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who attended.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the professional development event.",
            "x-references": "professionalDevelopmentEvent.namespace",
            "x-references-legs": [
              "professionalDevelopmentTitle"
            ],
            "x-onDelete": "restrict"
          },
          "professionalDevelopmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Title of the professional development event."
          },
          "attendanceDate": {
            "type": "string",
            "format": "date",
            "description": "Date of attendance."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Attendance event category."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "Reason for the attendance event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "namespace",
          "professionalDevelopmentTitle",
          "attendanceDate",
          "attendanceEventCategoryDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "Program": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationId, programName, programTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId that owns this program (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (e.g., Title I Part A, Special Education, Bilingual/English as a New Language)."
          },
          "programId": {
            "type": "string",
            "maxLength": 20,
            "description": "A unique number or alphanumeric code assigned to a program by a school, school system, state, or other agency or entity."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "programCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic of the program (e.g., year-round, full-day, half-day)."
                }
              },
              "required": [
                "programCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a program (e.g., year-round, full-day), discriminated by the program characteristic descriptor. Collection child of Program. Items unique by (programCharacteristicDescriptor)."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identifier for the learning standard this program addresses. Cross-fragment FK to the LearningStandard entity. References `learningStandard.learningStandardId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                }
              },
              "required": [
                "learningStandardId"
              ]
            },
            "description": "An association between a program and a learning standard that the program addresses. Collection child of Program with a cross-fragment FK to LearningStandard (resolves at wire-verify time). Items unique by (learningStandardId)."
          },
          "sponsors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "programSponsorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The sponsor of the program (e.g., Federal Government, State Government, Local Agency)."
                }
              },
              "required": [
                "programSponsorDescriptor"
              ]
            },
            "description": "An entity that provides financial support or other backing for a program (e.g., federal government, state government, local agency), discriminated by the program sponsor descriptor. Collection child of Program. Items unique by (programSponsorDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this program record. Programs are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this program is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "ProgramDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationId, programName, programTypeDescriptor, dimensionName).",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "dimensionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name of the program dimension (e.g., Academic Achievement, Social-Emotional)."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTag": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "A reporting tag for the program dimension."
                }
              },
              "required": [
                "reportingTag"
              ]
            },
            "description": "A reporting tag associated with a program dimension, used for categorization and filtering of evaluation results. Collection child of ProgramDimension. Items unique by (reportingTag)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "dimensionName",
          "recordState",
          "updatedAt"
        ]
      },
      "ProgramEvaluation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the evaluation is conducted (e.g., Annual, Mid-Year)."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program evaluation (e.g., Formative, Summative)."
          },
          "programEvaluationDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "A description of the program evaluation."
          },
          "maxRating": {
            "type": "integer",
            "description": "The maximum summary numerical rating or score for the program evaluation."
          },
          "minRating": {
            "type": "integer",
            "description": "The minimum summary numerical rating or score for the program evaluation."
          },
          "levels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor (e.g., Exceeds Expectations, Meets Expectations)."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation. Collection child of ProgramEvaluation. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "ProgramEvaluationElement": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program evaluation.",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the parent evaluation is conducted."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program evaluation."
          },
          "programEvaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the evaluation element."
          },
          "programEvaluationElementDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "A description of the program evaluation element."
          },
          "maxRating": {
            "type": "integer",
            "description": "The maximum rating for this evaluation element."
          },
          "minRating": {
            "type": "integer",
            "description": "The minimum rating for this evaluation element."
          },
          "programEvaluationLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor for this evaluation element level."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation element. Collection child of ProgramEvaluationElement. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "programEvaluationElementTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "ProgramEvaluationObjective": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program evaluation.",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the parent evaluation is conducted."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program evaluation."
          },
          "programEvaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the evaluation objective."
          },
          "programEvaluationObjectiveDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "A description of the program evaluation objective."
          },
          "maxRating": {
            "type": "integer",
            "description": "The maximum rating for this evaluation objective."
          },
          "minRating": {
            "type": "integer",
            "description": "The minimum rating for this evaluation objective."
          },
          "programEvaluationLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor for this evaluation objective level."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation objective. Collection child of ProgramEvaluationObjective. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "programEvaluationObjectiveTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "ProjectDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, code, fiscalYear). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "code",
          "fiscalYear",
          "recordState",
          "updatedAt"
        ]
      },
      "QuantitativeMeasure": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationObjectiveTitle, evaluationElementTitle, quantitativeMeasureIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation element.",
            "x-references": "evaluationElement.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "quantitativeMeasureIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Quantitative measure identifier."
          },
          "quantitativeMeasureTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Quantitative measure type."
          },
          "quantitativeMeasureDatatypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Quantitative measure datatype."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "quantitativeMeasureIdentifier",
          "recordState",
          "updatedAt"
        ]
      },
      "QuantitativeMeasureScore": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationDate, evaluationObjectiveTitle, evaluationElementTitle, quantitativeMeasureIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation element rating.",
            "x-references": "evaluationElementRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "quantitativeMeasureIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Quantitative measure identifier."
          },
          "scoreValue": {
            "type": "number",
            "description": "Score value."
          },
          "standardError": {
            "type": "number",
            "description": "Standard error."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "quantitativeMeasureIdentifier",
          "scoreValue",
          "recordState",
          "updatedAt"
        ]
      },
      "RecruitmentEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, eventTitle, eventDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization hosting the recruitment event. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title of the recruitment event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the recruitment event."
          },
          "eventDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "Description of the event."
          },
          "recruitmentEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type of recruitment event."
          },
          "eventLocation": {
            "type": "string",
            "maxLength": 255,
            "description": "Location of the event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "eventTitle",
          "eventDate",
          "recruitmentEventTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "RecruitmentEventAttendance": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, recruitmentEventAttendeeIdentifier, educationOrganizationSourcedId, eventTitle, eventDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "recruitmentEventAttendeeIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Identifier for the recruitment event attendee."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent recruitment event.",
            "x-references": "recruitmentEvent.educationOrganizationSourcedId",
            "x-references-legs": [
              "eventTitle",
              "eventDate"
            ],
            "x-onDelete": "restrict"
          },
          "eventTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title of the parent recruitment event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the parent recruitment event."
          },
          "electronicMailAddress": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Attendee email address."
          },
          "name": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal first name."
              },
              "lastSurname": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal last/surname."
              },
              "middleName": {
                "type": "string",
                "maxLength": 75,
                "description": "Middle name."
              },
              "personalTitlePrefix": {
                "type": "string",
                "maxLength": 30,
                "description": "Title prefix (e.g., Mr., Dr.)."
              },
              "generationCodeSuffix": {
                "type": "string",
                "maxLength": 10,
                "description": "Generation suffix (e.g., Jr., III)."
              },
              "maidenName": {
                "type": "string",
                "maxLength": 75,
                "description": "Maiden name."
              },
              "preferredFirstName": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred first name."
              },
              "preferredLastSurname": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred last/surname."
              }
            },
            "required": [
              "firstName",
              "lastSurname"
            ],
            "description": "Full legal name of the person."
          },
          "applied": {
            "type": "boolean",
            "description": "Whether the attendee has applied."
          },
          "met": {
            "type": "boolean",
            "description": "Whether the attendee was met."
          },
          "notes": {
            "type": "string",
            "maxLength": 255,
            "description": "Notes about the attendee."
          },
          "preScreeningRating": {
            "type": "integer",
            "description": "Pre-screening rating."
          },
          "recruitmentEventAttendeeTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Attendee type."
          },
          "referral": {
            "type": "boolean",
            "description": "Referral indicator."
          },
          "referredBy": {
            "type": "string",
            "maxLength": 50,
            "description": "Who referred the attendee."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Sex."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "Gender identity."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race designations."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "socialMediaNetworkName": {
            "type": "string",
            "maxLength": 50,
            "description": "Social media network name."
          },
          "socialMediaUserName": {
            "type": "string",
            "maxLength": 50,
            "description": "Social media user name."
          },
          "currentPosition": {
            "type": "object",
            "properties": {
              "nameOfInstitution": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Institution name."
              },
              "location": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Location."
              },
              "positionTitle": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "description": "Position title."
              },
              "academicSubjectDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "Academic subject."
              },
              "gradeLevels": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "gradeLevelDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Grade level."
                    }
                  },
                  "required": [
                    "gradeLevelDescriptor"
                  ],
                  "description": "gradeLevelsItem value."
                },
                "description": "Grade levels."
              }
            },
            "required": [
              "nameOfInstitution",
              "location",
              "positionTitle"
            ],
            "description": "Current position of the attendee."
          },
          "recruitmentEventAttendeeQualifications": {
            "type": "object",
            "properties": {
              "eligible": {
                "type": "boolean",
                "description": "Eligible indicator."
              },
              "capacityToServe": {
                "type": "boolean",
                "description": "Capacity to serve."
              },
              "yearsOfServiceCurrentPlacement": {
                "type": "number",
                "description": "Years in current placement."
              },
              "yearsOfServiceTotal": {
                "type": "number",
                "description": "Total years of service."
              }
            },
            "required": [
              "eligible",
              "yearsOfServiceTotal"
            ],
            "description": "Attendee qualifications."
          },
          "touchpoints": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "touchpointContent": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Touchpoint content."
                },
                "touchpointDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Touchpoint date."
                }
              },
              "required": [
                "touchpointContent",
                "touchpointDate"
              ],
              "description": "touchpointsItem value."
            },
            "description": "Touchpoints with the attendee (folded)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "recruitmentEventAttendeeIdentifier",
          "educationOrganizationSourcedId",
          "eventTitle",
          "eventDate",
          "electronicMailAddress",
          "name",
          "recordState",
          "updatedAt"
        ]
      },
      "ReportCard": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student this report card belongs to.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization responsible for the report card."
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grading period for which the report card is issued."
          },
          "periodSequence": {
            "type": "integer",
            "description": "The sequential order of this grading period."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school that issued the report card.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "numberOfDaysAbsent": {
            "type": "number",
            "description": "Number of days absent during the grading period."
          },
          "numberOfDaysInAttendance": {
            "type": "number",
            "description": "Number of days in attendance during the grading period."
          },
          "numberOfDaysTardy": {
            "type": "number",
            "description": "Number of days tardy during the grading period."
          },
          "gpaGivenGradingPeriod": {
            "type": "number",
            "description": "GPA for the given grading period on this report card."
          },
          "gpaCumulative": {
            "type": "number",
            "description": "The cumulative GPA."
          },
          "grades": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of grade (e.g., Exam, Final, Grading Period)."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The local course code for the grade entry."
                },
                "letterGradeEarned": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The letter grade earned."
                },
                "numericGradeEarned": {
                  "type": "number",
                  "description": "The numeric grade earned."
                }
              },
              "required": [
                "gradeTypeDescriptor",
                "localCourseCode"
              ]
            },
            "description": "A grade entry on a report card, linking a specific grade to the report card. Collection child of ReportCard. Items unique by (gradeTypeDescriptor, localCourseCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this report card record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "gradingPeriodDescriptor",
          "periodSequence",
          "schoolYear",
          "schoolSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "RestraintEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student involved in the restraint event. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the restraint event occurred. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "restraintEventIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A unique identifier for this restraint event within the student and school context."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the restraint event occurred."
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "restraintEventReasonDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reason for the restraint event (e.g., Imminent Serious Physical Harm to Self, Imminent Serious Physical Harm to Others)."
                }
              },
              "required": [
                "restraintEventReasonDescriptor"
              ]
            },
            "description": "A collection child of restraintEvent that records the reason(s) for a restraint event. References the parent restraint event via composite FK with soft-cascade delete. Items unique by (restraintEventReasonDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this restraint event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "restraintEventIdentifier",
          "eventDate",
          "recordState",
          "updatedAt"
        ]
      },
      "RubricDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationObjectiveTitle, evaluationElementTitle, rubricRating). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation element.",
            "x-references": "evaluationElement.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "rubricRating": {
            "type": "integer",
            "description": "Rubric rating value."
          },
          "criterionDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Criterion description."
          },
          "rubricRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Rubric rating level."
          },
          "dimensionOrder": {
            "type": "integer",
            "description": "Dimension order."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "rubricRating",
          "criterionDescription",
          "recordState",
          "updatedAt"
        ]
      },
      "School": {
        "type": "object",
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies this school in the roster layer. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the school (OneRoster org name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "school"
            ],
            "description": "RESTRICTED to the org type \"school\" — only school-rung org rows are visible through this projection."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 256,
            "description": "An abbreviated or commonly-used name for the school."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the school's public website."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The operational status of the school (e.g. Active, Inactive, New). References the OperationalStatusDescriptor governed value."
          },
          "schoolTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of school (e.g. Regular, Alternative, Career and Technical Education). References the SchoolTypeDescriptor governed value."
          },
          "charterStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The charter status of the school (e.g. School Charter, Open Enrollment Charter, Not a Charter School). References the CharterStatusDescriptor governed value."
          },
          "titleIPartASchoolDesignationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The Title I Part A designation for the school (e.g. Schoolwide, Targeted Assistance, Not Designated). References the TitleIPartASchoolDesignationDescriptor governed value."
          },
          "magnetSpecialProgramEmphasisSchoolDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of magnet or special program emphasis for the school. References the MagnetSpecialProgramEmphasisSchoolDescriptor governed value."
          },
          "administrativeFundingControlDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The administrative funding control classification (e.g. Public School, Private School). References the AdministrativeFundingControlDescriptor governed value."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a school education organization. A school may have multiple addresses differentiated by address type (e.g. Physical, Mailing). Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this school (e.g. Elementary School, Middle School, High School). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a school education organization. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level offered (e.g. First grade, Ninth grade, Twelfth grade). References the GradeLevelDescriptor governed value."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level offered by a school education organization. Items unique by (gradeLevelDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal, Other Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a school by an external system (e.g. NCES, state education agency). Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax, Attendance line). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a school education organization, classified by type (e.g. Main, Fax, Attendance). Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this school record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "nameOfInstitution",
          "type",
          "dateLastModified"
        ]
      },
      "SchoolExtension": {
        "type": "object",
        "properties": {
          "orgSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Shared natural id with the OneRoster org this school extension belongs to 1:1. FK CASCADE so deleting the org reaps the companion.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 256,
            "description": "An abbreviated or commonly-used name for the school."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the school's public website."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The operational status of the school (e.g. Active, Inactive, New). References the OperationalStatusDescriptor governed value."
          },
          "schoolTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of school (e.g. Regular, Alternative, Career and Technical Education). References the SchoolTypeDescriptor governed value."
          },
          "charterStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The charter status of the school (e.g. School Charter, Open Enrollment Charter, Not a Charter School). References the CharterStatusDescriptor governed value."
          },
          "titleIPartASchoolDesignationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The Title I Part A designation for the school (e.g. Schoolwide, Targeted Assistance, Not Designated). References the TitleIPartASchoolDesignationDescriptor governed value."
          },
          "magnetSpecialProgramEmphasisSchoolDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of magnet or special program emphasis for the school. References the MagnetSpecialProgramEmphasisSchoolDescriptor governed value."
          },
          "administrativeFundingControlDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The administrative funding control classification (e.g. Public School, Private School). References the AdministrativeFundingControlDescriptor governed value."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a school education organization. A school may have multiple addresses differentiated by address type (e.g. Physical, Mailing). Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this school (e.g. Elementary School, Middle School, High School). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a school education organization. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level offered (e.g. First grade, Ninth grade, Twelfth grade). References the GradeLevelDescriptor governed value."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level offered by a school education organization. Items unique by (gradeLevelDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal, Other Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a school by an external system (e.g. NCES, state education agency). Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax, Attendance line). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a school education organization, classified by type (e.g. Main, Fax, Attendance). Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this school record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        },
        "required": [
          "orgSourcedId"
        ]
      },
      "Section": {
        "type": "object",
        "properties": {
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster class sourcedId that this section maps to one-for-one. Shared roster field — UPDATE requires edfi:write-shared. Also the 1:1 join key into sectionExtension."
          },
          "sectionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "A locally-defined name for the section (OneRoster class title). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster organization sourcedId identifying the school where this section is offered. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering to which this section belongs."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The identifier for the school year in which the section is offered."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term descriptor for the session in which this section is offered (e.g., Fall Semester, Spring Semester)."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to a section."
          },
          "sequenceOfCourse": {
            "type": "integer",
            "minimum": 1,
            "description": "When a section is part of a sequence of parts for a course, the number of the sequence."
          },
          "officialAttendancePeriod": {
            "type": "boolean",
            "description": "Indicator of whether this section is used for official daily attendance."
          },
          "availableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The number of credits available."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value awarded for the completion of a course."
          },
          "sectionTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "A descriptor specifying the type of section (e.g., Attendance, Credit)."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which a child receives education and related services (e.g., Classroom, Homebound)."
          },
          "mediumOfInstructionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The media through which teachers provide instruction (e.g., Face-to-face, Virtual)."
          },
          "populationServedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of students the section is offered and tailored to (e.g., Regular Students, Gifted and Talented)."
          },
          "instructionLanguageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The primary language of instruction."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sectionCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of section characteristic (e.g., Magnet, Self-Contained, Inclusion)."
                }
              },
              "required": [
                "sectionCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a section (e.g., Magnet, Self-Contained), discriminated by the section characteristic descriptor. Items unique by (sectionCharacteristicDescriptor)."
          },
          "classPeriods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "classPeriodName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The name of the class period during which the section meets."
                }
              },
              "required": [
                "classPeriodName"
              ]
            },
            "description": "An association between a section and one or more class periods during which the section meets. Items unique by (classPeriodName)."
          },
          "courseLevelCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of course level characteristic (e.g., Honors, AP, IB, Dual Credit)."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a section's course level (e.g., Honors, AP, IB), discriminated by the course level characteristic descriptor. Items unique by (courseLevelCharacteristicDescriptor)."
          },
          "offeredGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which this section is offered (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level for which a section is offered, discriminated by the grade level descriptor. Items unique by (gradeLevelDescriptor)."
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The education organization that owns the referenced program. Validated at the command layer against Program (educationOrganizationId+programName+programTypeDescriptor) — the FK does not survive the jsonb fold."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "The formal name of the program."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Bilingual, Special Education)."
                }
              },
              "required": [
                "educationOrganizationId",
                "programName",
                "programTypeDescriptor"
              ]
            },
            "description": "An association between a section and a program, indicating that the section is part of a particular program. Items unique by (educationOrganizationId, programName, programTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "classSourcedId",
          "sectionName",
          "schoolSourcedId",
          "localCourseCode",
          "schoolYear",
          "termDescriptor",
          "sectionIdentifier",
          "recordState",
          "dateLastModified"
        ]
      },
      "SectionAttendanceTakenEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where attendance was taken.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The class (section) for which attendance was taken.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The calendar code indicating the instructional calendar associated with the event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which attendance was taken."
          },
          "sectionIdentifier": {
            "type": "string",
            "maxLength": 255,
            "description": "The local identifier assigned to the section."
          },
          "localCourseCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "staffSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The staff member who took attendance for this section.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "schoolSourcedId",
          "classSourcedId",
          "calendarCode",
          "eventDate",
          "recordState",
          "updatedAt"
        ]
      },
      "SectionExtension": {
        "type": "object",
        "properties": {
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Shared natural id with the OneRoster class this section extends 1:1. FK CASCADE so deleting the class reaps the companion.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "cascade"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering to which this section belongs."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The identifier for the school year in which the section is offered."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term descriptor for the session in which this section is offered (e.g., Fall Semester, Spring Semester)."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to a section."
          },
          "sequenceOfCourse": {
            "type": "integer",
            "minimum": 1,
            "description": "When a section is part of a sequence of parts for a course, the number of the sequence."
          },
          "officialAttendancePeriod": {
            "type": "boolean",
            "description": "Indicator of whether this section is used for official daily attendance."
          },
          "availableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The number of credits available."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value awarded for the completion of a course."
          },
          "sectionTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "A descriptor specifying the type of section (e.g., Attendance, Credit)."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which a child receives education and related services (e.g., Classroom, Homebound)."
          },
          "mediumOfInstructionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The media through which teachers provide instruction (e.g., Face-to-face, Virtual)."
          },
          "populationServedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of students the section is offered and tailored to (e.g., Regular Students, Gifted and Talented)."
          },
          "instructionLanguageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The primary language of instruction."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sectionCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of section characteristic (e.g., Magnet, Self-Contained, Inclusion)."
                }
              },
              "required": [
                "sectionCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a section (e.g., Magnet, Self-Contained), discriminated by the section characteristic descriptor. Items unique by (sectionCharacteristicDescriptor)."
          },
          "classPeriods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "classPeriodName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The name of the class period during which the section meets."
                }
              },
              "required": [
                "classPeriodName"
              ]
            },
            "description": "An association between a section and one or more class periods during which the section meets. Items unique by (classPeriodName)."
          },
          "courseLevelCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of course level characteristic (e.g., Honors, AP, IB, Dual Credit)."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a section's course level (e.g., Honors, AP, IB), discriminated by the course level characteristic descriptor. Items unique by (courseLevelCharacteristicDescriptor)."
          },
          "offeredGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which this section is offered (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level for which a section is offered, discriminated by the grade level descriptor. Items unique by (gradeLevelDescriptor)."
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The education organization that owns the referenced program. Validated at the command layer against Program (educationOrganizationId+programName+programTypeDescriptor) — the FK does not survive the jsonb fold."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "The formal name of the program."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Bilingual, Special Education)."
                }
              },
              "required": [
                "educationOrganizationId",
                "programName",
                "programTypeDescriptor"
              ]
            },
            "description": "An association between a section and a program, indicating that the section is part of a particular program. Items unique by (educationOrganizationId, programName, programTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        },
        "required": [
          "classSourcedId",
          "localCourseCode",
          "schoolYear",
          "termDescriptor",
          "sectionIdentifier",
          "recordState"
        ]
      },
      "Session": {
        "type": "object",
        "properties": {
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The descriptive name of the session (e.g. 'Fall Semester', 'Q1'). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The first calendar date of the session. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The last calendar date of the session. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year to which this session belongs. Cast from the OneRoster four-digit school-year string. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this session belongs to. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "term",
              "semester"
            ],
            "description": "RESTRICTED to the session types \"term\" and \"semester\" — only these rows are visible through this projection."
          },
          "totalInstructionalDays": {
            "type": "integer",
            "minimum": 0,
            "description": "The total number of instructional days in the session."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The descriptive name of the session (e.g. 'Fall Semester', 'Q1'). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "gradingPeriods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradingPeriodDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grading period descriptor identifying the type of grading period (e.g. First Six Weeks, Second Semester). References the GradingPeriodDescriptor governed value."
                },
                "periodSequence": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The sequential order of the grading period within the session."
                }
              },
              "required": [
                "gradingPeriodDescriptor",
                "periodSequence"
              ]
            },
            "description": "An association between a session and a grading period, establishing which grading periods fall within a given session. Items unique by (gradingPeriodDescriptor, periodSequence)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this session record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "sessionName",
          "beginDate",
          "endDate",
          "schoolYear",
          "schoolSourcedId",
          "type",
          "termDescriptor",
          "dateLastModified"
        ]
      },
      "SessionExtension": {
        "type": "object",
        "properties": {
          "academicSessionSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Shared natural id with the OneRoster academicSession this session extension belongs to 1:1. FK CASCADE so deleting the academicSession reaps the companion.",
            "x-references": "oneroster:academicSession.sourcedId",
            "x-onDelete": "cascade"
          },
          "totalInstructionalDays": {
            "type": "integer",
            "minimum": 0,
            "description": "The total number of instructional days in the session."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The term descriptor for this session (e.g. Fall Semester, Spring Semester, Year Round). References the TermDescriptor governed value."
          },
          "gradingPeriods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradingPeriodDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grading period descriptor identifying the type of grading period (e.g. First Six Weeks, Second Semester). References the GradingPeriodDescriptor governed value."
                },
                "periodSequence": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The sequential order of the grading period within the session."
                }
              },
              "required": [
                "gradingPeriodDescriptor",
                "periodSequence"
              ]
            },
            "description": "An association between a session and a grading period, establishing which grading periods fall within a given session. Items unique by (gradingPeriodDescriptor, periodSequence)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this session record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        },
        "required": [
          "academicSessionSourcedId"
        ]
      },
      "SourceDimension": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, code, fiscalYear). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "code",
          "fiscalYear",
          "recordState",
          "updatedAt"
        ]
      },
      "Staff": {
        "type": "object",
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster user sourcedId that anchors this staff member's roster identity. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The staff member's legal first name (OneRoster given name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The staff member's legal last/surname (OneRoster family name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "middleName": {
            "type": "string",
            "maxLength": 256,
            "description": "The staff member's middle name, if any. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "staffUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a staff member by the district. Ed-Fi-owned extends field; second component of the derived-hash GUID."
          },
          "generationCodeSuffix": {
            "type": "string",
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III). Stored under a staff-prefixed column because edfi:student also extends oneroster:user with a generationCodeSuffix field; exposed on the wire as generationCodeSuffix."
          },
          "maidenName": {
            "type": "string",
            "maxLength": 75,
            "description": "The staff member's maiden name, if applicable. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as maidenName."
          },
          "personalTitlePrefix": {
            "type": "string",
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the staff member. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as personalTitlePrefix."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the staff member was born. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as birthDate."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The staff member's sex at birth. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as sexDescriptor."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central and South America, and other Spanish cultures."
          },
          "highestCompletedLevelOfEducationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The extent of formal instruction an individual has received (e.g., the highest grade in school completed or its equivalent or the highest degree received)."
          },
          "yearsOfPriorProfessionalExperience": {
            "type": "number",
            "description": "The total number of years that an individual has previously held a similar professional position in one or more education institutions."
          },
          "yearsOfPriorTeachingExperience": {
            "type": "number",
            "description": "The total number of years that an individual has previously held a teaching position in one or more education institutions."
          },
          "loginId": {
            "type": "string",
            "maxLength": 60,
            "description": "The login identifier for the staff member, if applicable."
          },
          "highlyQualifiedTeacher": {
            "type": "boolean",
            "description": "An indication of whether a teacher is classified as highly qualified for his/her assignment according to state definition."
          },
          "citizenshipStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indicator of whether or not the person is a U.S. citizen. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as citizenshipStatusDescriptor."
          },
          "oldEthnicityDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Previous definition of ethnicity combining combos of race and ethnicity."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which the address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state or jurisdiction in which the address is located."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of the address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which the address is located."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "A postal address associated with a staff member, discriminated by address type. Multiple addresses per staff member are supported (home, mailing, physical, etc.). Items unique by (addressTypeDescriptor, city, postalCode, streetNumberName, stateAbbreviationDescriptor)."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "staffCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic or trait attributed to the staff member."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or no longer applicable."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "staffCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to the staff member (e.g., Migrant, Homeless, Displaced Homemaker), discriminated by characteristic descriptor. Items unique by (staffCharacteristicDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as characteristics."
          },
          "credentials": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the name of the state that issued the credential."
                },
                "credentialFieldDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The field of certification for the credential (e.g., Mathematics, Early Childhood)."
                },
                "credentialTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the category of credential an individual holds (e.g., Certification, Endorsement)."
                },
                "levelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level(s) certified for the credential."
                },
                "teachingCredentialDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the category of a legal document giving authorization to perform teaching assignment services."
                },
                "issuanceDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which an active credential was issued to an individual."
                },
                "expirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which an active credential held by an individual will expire."
                },
                "teachingCredentialBasisDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the pre-determined criteria for granting the teaching credential that an individual holds."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "A credential (license, certificate, endorsement) held by a staff member, discriminated by credential identifier and state of issue. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the staff member."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the staff member."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a staff member, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as electronicMails."
          },
          "identificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to verify a staff member's identity, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as identificationDocuments."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a staff member, discriminated by address type. Items unique by (addressTypeDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as internationalAddresses."
          },
          "languageUses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language."
                },
                "languageUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A description of how the language is used (e.g., Home language, Dominant language, Correspondence language)."
                }
              },
              "required": [
                "languageDescriptor",
                "languageUseDescriptor"
              ]
            },
            "description": "A description of how the language is used by the staff member (e.g., spoken, written, correspondence), discriminated by language and use descriptors. Items unique by (languageDescriptor, languageUseDescriptor)."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language the staff member speaks or understands."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language spoken or understood by the staff member, discriminated by language descriptor. Items unique by (languageDescriptor)."
          },
          "otherNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a staff member (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The staff member's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The staff member's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The staff member's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the staff member is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as otherNames."
          },
          "personalIdentificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document presented by a staff member for verification purposes, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as personalIdentificationDocuments."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category which most clearly reflects the individual's recognition of their community or with which the individual most identifies."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "A race designation for the staff member as reported to the education organization, allowing multiple race entries per staff member. Items unique by (raceDescriptor)."
          },
          "recognitions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "recognitionTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The nature of recognition given to the staff member for accomplishments in a co-curricular, or extra-curricular activity."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title assigned to the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement attributed to the individual."
                },
                "achievementCategorySystem": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The system that defines the categories of achievement for the individual."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the agent issuing the recognition."
                },
                "issuerOriginURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) from which the recognition was issued."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for competency-based completion of the achievement/award."
                },
                "criteriaURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) for the unique address of a web page describing the competency-based completion criteria."
                },
                "evidenceStatement": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "A statement or reference describing the evidence that the individual met the criteria for attainment of the achievement."
                },
                "imageURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) for the unique address of an image representing an award or badge associated with the achievement."
                },
                "recognitionDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the type of academic distinctions earned by or awarded to the individual."
                },
                "recognitionAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition was awarded or earned."
                },
                "recognitionAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date on which the recognition expires."
                }
              },
              "required": [
                "recognitionTypeDescriptor"
              ]
            },
            "description": "A recognition or award given to the staff member, discriminated by recognition type. Items unique by (recognitionTypeDescriptor)."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of communication number listed for the staff member (e.g., Home, Mobile, Work)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code, and extension, if applicable."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number associated with a staff member, discriminated by telephone number type. Items unique by (telephoneNumberTypeDescriptor, telephoneNumber)."
          },
          "tribalAffiliations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An American Indian tribe with which the staff member is affiliated."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ]
            },
            "description": "A tribal affiliation held by the staff member, discriminated by tribal affiliation descriptor. Items unique by (tribalAffiliationDescriptor)."
          },
          "visas": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "visaDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An indicator of a non-U.S. citizen's visa type."
                }
              },
              "required": [
                "visaDescriptor"
              ]
            },
            "description": "A visa type held by the staff member, discriminated by visa descriptor. Items unique by (visaDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as visas."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this staff record. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as recordState.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as deleteSource."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "firstName",
          "lastSurname",
          "staffUniqueId",
          "birthDate",
          "recordState",
          "dateLastModified"
        ]
      },
      "StaffAbsenceEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, eventDate, absenceEventCategoryDescriptor).",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with this absence event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date for this leave event."
          },
          "absenceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The code describing the type of absence."
          },
          "absenceEventReason": {
            "type": "string",
            "maxLength": 40,
            "description": "Expanded reason for the staff absence."
          },
          "hoursAbsent": {
            "type": "number",
            "description": "The hours the staff was absent, if not the entire working day."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "eventDate",
          "absenceEventCategoryDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffCohortAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member assigned to the cohort.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined the cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the staff member was assigned to the cohort."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the staff member was removed from the cohort."
          },
          "studentRecordAccess": {
            "type": "boolean",
            "description": "An indication of whether the staff member has access to student records for the cohort."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this staff cohort association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationId",
          "cohortIdentifier",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffDemographic": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The staff member's birth sex."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "Gender identity as last reported."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "citizenship": {
            "type": "object",
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation for the individual."
          },
          "ancestryEthnicOrigins": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ancestryEthnicOriginDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Ancestry ethnic origin."
                }
              },
              "required": [
                "ancestryEthnicOriginDescriptor"
              ],
              "description": "ancestryEthnicOriginsItem value."
            },
            "description": "Ancestry ethnic origins."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race category."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race categories."
          },
          "tribalAffiliations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Tribal affiliation."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ],
              "description": "tribalAffiliationsItem value."
            },
            "description": "Tribal affiliations."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffDirectory": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The email address."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Priority order of this number."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffDisciplineIncidentAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, schoolSourcedId, incidentIdentifier).",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with the discipline incident.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the discipline incident (disciplineIncident natural-key leg; oneroster:org sourcedId).",
            "x-references": "disciplineIncident.schoolSourcedId",
            "x-references-legs": [
              "incidentIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "Locally assigned unique identifier of the discipline incident."
          },
          "disciplineIncidentParticipationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disciplineIncidentParticipationCodeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The role or type of participation of the staff in a discipline incident."
                }
              },
              "required": [
                "disciplineIncidentParticipationCodeDescriptor"
              ]
            },
            "description": "Participation roles of the staff in the discipline incident. Required folded descriptor collection. Items unique by (disciplineIncidentParticipationCodeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "schoolSourcedId",
          "incidentIdentifier",
          "disciplineIncidentParticipationCodes",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffEducationOrganizationAssignmentAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, educationOrganizationSourcedId, staffClassificationDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member assigned to this education organization.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization to which the staff member is assigned.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The titles of employment, official status, or rank of education staff. Discriminator in the natural key identifying distinct classification assignments at the same organization."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the start of the staff member's assignment to the education organization under this classification."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the end of the staff member's assignment. NULL means the assignment is still active."
          },
          "positionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The descriptive name of an individual's position."
          },
          "orderOfAssignment": {
            "type": "integer",
            "minimum": 1,
            "description": "Describes whether the assignment is this individual's primary assignment or if the assignment is a secondary assignment."
          },
          "credentialFieldDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The field of certification for the certificate (e.g., Mathematics, Music)."
          },
          "fullTimeEquivalency": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "The ratio between the hours of work expected in a position and the hours of work normally expected in a full-time position in the same setting."
          },
          "employmentEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The sourcedId of the education organization where the staff member is employed while assigned to this education organization."
          },
          "employmentStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Reflects the type of employment or contract associated with the staff member's assignment."
          },
          "employmentHireDate": {
            "type": "string",
            "format": "date",
            "description": "The hire date associated with the staff member's employment at the employing education organization."
          },
          "credentials": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which the credential was issued."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "The credentials held by the staff member that are relevant to the assignment at the education organization. A multi-valued collection child of StaffEducationOrganizationAssignmentAssociation keyed by the parent's natural key plus the credential identifier discriminator. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "staffClassificationDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffEducationOrganizationEmploymentAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, educationOrganizationSourcedId, employmentStatusDescriptor, hireDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member employed by this education organization.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization employing the staff member.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "employmentStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Reflects the type of employment or contract (e.g., Tenured, Non-Tenured, Substitute, Contractual). Discriminator in the natural key identifying distinct employment relationships at the same organization."
          },
          "hireDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an individual was hired for a position."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the employment association ends. NULL means the employment is still active."
          },
          "department": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The department or suborganization the employee/contractor is associated with in the education organization."
          },
          "hourlyWage": {
            "type": "number",
            "minimum": 0,
            "description": "The hourly wage associated with the employment position being reported."
          },
          "annualWage": {
            "type": "number",
            "minimum": 0,
            "description": "The annual wage associated with the employment position being reported."
          },
          "offerDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the employment offer."
          },
          "separationDate": {
            "type": "string",
            "format": "date",
            "description": "The date the staff member's employment ended or will end (formal separation)."
          },
          "separationReasonDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason for the staff member's separation from the education organization (e.g., Retirement, Resignation, Involuntary)."
          },
          "separationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of separation (e.g., Voluntary, Involuntary, Mutual agreement)."
          },
          "credentialFieldDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The field of certification for the certificate associated with this employment (e.g., Mathematics, Music)."
          },
          "fullTimeEquivalency": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "The ratio between the hours of work expected in a position and the hours of work normally expected in a full-time position in the same setting."
          },
          "credentials": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which the credential was issued."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "The credentials held by the staff member that are relevant to their employment at the education organization. A multi-valued collection child of StaffEducationOrganizationEmploymentAssociation keyed by the parent's natural key plus the credential identifier discriminator. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "employmentStatusDescriptor",
          "hireDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffEducatorPreparationProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, educationOrganizationSourcedId, programName, programTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the EPP.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "EPP program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "EPP program type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Association begin date."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Association end date."
          },
          "completer": {
            "type": "boolean",
            "description": "Whether the staff member completed the program."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffExtension": {
        "type": "object",
        "properties": {
          "userSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Shared natural id with the OneRoster user this staff extension belongs to 1:1. FK CASCADE so deleting the user reaps the companion.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "cascade"
          },
          "staffUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a staff member by the district. Ed-Fi-owned extends field; second component of the derived-hash GUID."
          },
          "generationCodeSuffix": {
            "type": "string",
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III). Stored under a staff-prefixed column because edfi:student also extends oneroster:user with a generationCodeSuffix field; exposed on the wire as generationCodeSuffix."
          },
          "maidenName": {
            "type": "string",
            "maxLength": 75,
            "description": "The staff member's maiden name, if applicable. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as maidenName."
          },
          "personalTitlePrefix": {
            "type": "string",
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the staff member. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as personalTitlePrefix."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the staff member was born. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as birthDate."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The staff member's sex at birth. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as sexDescriptor."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central and South America, and other Spanish cultures."
          },
          "highestCompletedLevelOfEducationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The extent of formal instruction an individual has received (e.g., the highest grade in school completed or its equivalent or the highest degree received)."
          },
          "yearsOfPriorProfessionalExperience": {
            "type": "number",
            "description": "The total number of years that an individual has previously held a similar professional position in one or more education institutions."
          },
          "yearsOfPriorTeachingExperience": {
            "type": "number",
            "description": "The total number of years that an individual has previously held a teaching position in one or more education institutions."
          },
          "loginId": {
            "type": "string",
            "maxLength": 60,
            "description": "The login identifier for the staff member, if applicable."
          },
          "highlyQualifiedTeacher": {
            "type": "boolean",
            "description": "An indication of whether a teacher is classified as highly qualified for his/her assignment according to state definition."
          },
          "citizenshipStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indicator of whether or not the person is a U.S. citizen. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as citizenshipStatusDescriptor."
          },
          "oldEthnicityDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Previous definition of ethnicity combining combos of race and ethnicity."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which the address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state or jurisdiction in which the address is located."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of the address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which the address is located."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "A postal address associated with a staff member, discriminated by address type. Multiple addresses per staff member are supported (home, mailing, physical, etc.). Items unique by (addressTypeDescriptor, city, postalCode, streetNumberName, stateAbbreviationDescriptor)."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "staffCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic or trait attributed to the staff member."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or no longer applicable."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "staffCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to the staff member (e.g., Migrant, Homeless, Displaced Homemaker), discriminated by characteristic descriptor. Items unique by (staffCharacteristicDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as characteristics."
          },
          "credentials": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the name of the state that issued the credential."
                },
                "credentialFieldDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The field of certification for the credential (e.g., Mathematics, Early Childhood)."
                },
                "credentialTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the category of credential an individual holds (e.g., Certification, Endorsement)."
                },
                "levelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level(s) certified for the credential."
                },
                "teachingCredentialDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the category of a legal document giving authorization to perform teaching assignment services."
                },
                "issuanceDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which an active credential was issued to an individual."
                },
                "expirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which an active credential held by an individual will expire."
                },
                "teachingCredentialBasisDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the pre-determined criteria for granting the teaching credential that an individual holds."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "A credential (license, certificate, endorsement) held by a staff member, discriminated by credential identifier and state of issue. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the staff member."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the staff member."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a staff member, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as electronicMails."
          },
          "identificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to verify a staff member's identity, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as identificationDocuments."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a staff member, discriminated by address type. Items unique by (addressTypeDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as internationalAddresses."
          },
          "languageUses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language."
                },
                "languageUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A description of how the language is used (e.g., Home language, Dominant language, Correspondence language)."
                }
              },
              "required": [
                "languageDescriptor",
                "languageUseDescriptor"
              ]
            },
            "description": "A description of how the language is used by the staff member (e.g., spoken, written, correspondence), discriminated by language and use descriptors. Items unique by (languageDescriptor, languageUseDescriptor)."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language the staff member speaks or understands."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language spoken or understood by the staff member, discriminated by language descriptor. Items unique by (languageDescriptor)."
          },
          "otherNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a staff member (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The staff member's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The staff member's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The staff member's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the staff member is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as otherNames."
          },
          "personalIdentificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document presented by a staff member for verification purposes, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as personalIdentificationDocuments."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category which most clearly reflects the individual's recognition of their community or with which the individual most identifies."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "A race designation for the staff member as reported to the education organization, allowing multiple race entries per staff member. Items unique by (raceDescriptor)."
          },
          "recognitions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "recognitionTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The nature of recognition given to the staff member for accomplishments in a co-curricular, or extra-curricular activity."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title assigned to the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement attributed to the individual."
                },
                "achievementCategorySystem": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The system that defines the categories of achievement for the individual."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the agent issuing the recognition."
                },
                "issuerOriginURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) from which the recognition was issued."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for competency-based completion of the achievement/award."
                },
                "criteriaURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) for the unique address of a web page describing the competency-based completion criteria."
                },
                "evidenceStatement": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "A statement or reference describing the evidence that the individual met the criteria for attainment of the achievement."
                },
                "imageURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) for the unique address of an image representing an award or badge associated with the achievement."
                },
                "recognitionDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the type of academic distinctions earned by or awarded to the individual."
                },
                "recognitionAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition was awarded or earned."
                },
                "recognitionAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date on which the recognition expires."
                }
              },
              "required": [
                "recognitionTypeDescriptor"
              ]
            },
            "description": "A recognition or award given to the staff member, discriminated by recognition type. Items unique by (recognitionTypeDescriptor)."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of communication number listed for the staff member (e.g., Home, Mobile, Work)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code, and extension, if applicable."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number associated with a staff member, discriminated by telephone number type. Items unique by (telephoneNumberTypeDescriptor, telephoneNumber)."
          },
          "tribalAffiliations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An American Indian tribe with which the staff member is affiliated."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ]
            },
            "description": "A tribal affiliation held by the staff member, discriminated by tribal affiliation descriptor. Items unique by (tribalAffiliationDescriptor)."
          },
          "visas": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "visaDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An indicator of a non-U.S. citizen's visa type."
                }
              },
              "required": [
                "visaDescriptor"
              ]
            },
            "description": "A visa type held by the staff member, discriminated by visa descriptor. Items unique by (visaDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as visas."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this staff record. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as recordState.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as deleteSource."
          }
        },
        "required": [
          "userSourcedId"
        ]
      },
      "StaffIdentificationCode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member this identification code belongs to (references the oneroster:user record backing edfi:staff).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "cascade"
          },
          "staffUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The district-assigned unique identifier for the staff member, matching edfi:staff.staffUniqueId. Not enforced as a DB-level FK leg (staffUniqueId lives on the projection's extends, not the oneroster:user master); validated at the command layer."
          },
          "staffIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a staff member by a school, school system, state, or other agency or entity."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The organization code or name assigning the staff identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "staffUniqueId",
          "staffIdentificationSystemDescriptor",
          "identificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffLeave": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, beginDate, staffLeaveEventCategoryDescriptor).",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with this leave event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the staff leave."
          },
          "staffLeaveEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The code describing the type of leave taken."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the staff leave."
          },
          "reason": {
            "type": "string",
            "maxLength": 40,
            "description": "Expanded reason for the staff leave."
          },
          "substituteAssigned": {
            "type": "boolean",
            "description": "Indicator of whether a substitute was assigned during the period of staff leave."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "beginDate",
          "staffLeaveEventCategoryDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, educationOrganizationId, programName, programTypeDescriptor, beginDate).",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with the program. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program (program natural-key leg; also oneroster:org sourcedId).",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Start date for the association of staff to this program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "End date for the association of staff to this program."
          },
          "studentRecordAccess": {
            "type": "boolean",
            "description": "Indicator of whether the staff has access to the student records of the program."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffSchoolAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, staffSourcedId, schoolSourcedId, programAssignmentDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member providing services to this school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the school where the staff member provides services.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programAssignmentDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The name of the program for which the individual is assigned. Discriminator in the natural key identifying distinct assignments at the same school."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the staff member begins providing services to the school under this program assignment."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the staff member stops providing services to the school under this program assignment. NULL means the assignment is still active."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with this staff school assignment."
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar associated with the staff school association."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject the staff member is eligible to teach (e.g. Mathematics, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "The academic subjects the staff member is eligible to teach at the associated school. A multi-valued collection child of StaffSchoolAssociation keyed by the parent's natural key plus the academic subject descriptor discriminator. Items unique by (academicSubjectDescriptor)."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level the staff member is eligible to teach (e.g. Ninth grade, Kindergarten)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade levels the staff member is eligible to teach at the associated school. A multi-valued collection child of StaffSchoolAssociation keyed by the parent's natural key plus the grade level descriptor discriminator. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "schoolSourcedId",
          "programAssignmentDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StaffSectionAssociation": {
        "type": "object",
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the staff member assigned to this section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "classSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the class section to which the staff member is assigned. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the school organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of a teacher's assignment to the section. This date is both a natural key component and the effective-from date. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the last day of a staff member's assignment to the section. NULL means the assignment is still active. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "role": {
            "type": "string",
            "enum": [
              "teacher"
            ],
            "description": "RESTRICTED to the enrollment role \"teacher\" — only teacher enrollment rows are visible through this projection."
          },
          "classroomPositionDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of position the staff member holds in the specific class/section (e.g. Teacher of Record, Assistant Teacher, Support Teacher, Substitute Teacher)."
          },
          "highlyQualifiedTeacher": {
            "type": "boolean",
            "description": "An indication of whether a teacher is classified as highly qualified for his/her assignment according to state definition."
          },
          "teacherStudentDataLinkExclusion": {
            "type": "boolean",
            "description": "Indicates that the entire section is excluded from calculation of value-added or growth attribution calculations used for a particular teacher evaluation. NOTE: column is namespaced (staffTeacherStudentDataLinkExclusion) because oneroster:enrollment is also projected by edfi:studentSectionAssociation, which owns the plain teacherStudentDataLinkExclusion column; the wire name is unaffected."
          },
          "percentageContribution": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Indicates the percentage of the total scheduled course time, academic standards, and/or learning activities delivered in this section by this staff member."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "staffSourcedId",
          "classSourcedId",
          "schoolSourcedId",
          "beginDate",
          "role",
          "classroomPositionDescriptor",
          "recordState",
          "dateLastModified"
        ]
      },
      "StaffSectionAssociationExtension": {
        "type": "object",
        "properties": {
          "enrollmentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Shared natural id with the OneRoster enrollment this staff section association extension belongs to 1:1. FK CASCADE so deleting the enrollment reaps the companion.",
            "x-references": "oneroster:enrollment.sourcedId",
            "x-onDelete": "cascade"
          },
          "classroomPositionDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of position the staff member holds in the specific class/section (e.g. Teacher of Record, Assistant Teacher, Support Teacher, Substitute Teacher)."
          },
          "highlyQualifiedTeacher": {
            "type": "boolean",
            "description": "An indication of whether a teacher is classified as highly qualified for his/her assignment according to state definition."
          },
          "teacherStudentDataLinkExclusion": {
            "type": "boolean",
            "description": "Indicates that the entire section is excluded from calculation of value-added or growth attribution calculations used for a particular teacher evaluation. NOTE: column is namespaced (staffTeacherStudentDataLinkExclusion) because oneroster:enrollment is also projected by edfi:studentSectionAssociation, which owns the plain teacherStudentDataLinkExclusion column; the wire name is unaffected."
          },
          "percentageContribution": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Indicates the percentage of the total scheduled course time, academic standards, and/or learning activities delivered in this section by this staff member."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        },
        "required": [
          "enrollmentSourcedId"
        ]
      },
      "StateEducationAgency": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, stateEducationAgencyId). Used for `{id}` routing and If-Match concurrency.",
            "readOnly": true
          },
          "stateEducationAgencyId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The unique identifier for this state education agency within the tenant."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the state education agency."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the SEA's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a state education agency. An SEA may have multiple addresses differentiated by address type (e.g. Physical, Mailing). The composite natural key includes the address type and core location fields to allow multiple addresses per SEA. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this SEA (e.g. State Education Agency). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a state education agency. An SEA may belong to multiple education organization categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a state education agency by an external system (e.g. NCES, Federal). An SEA may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a state education agency, classified by type (e.g. Main, Fax). An SEA may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this SEA record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "stateEducationAgencyId",
          "nameOfInstitution",
          "updatedAt"
        ]
      },
      "Student": {
        "type": "object",
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster user sourcedId that anchors this student's roster identity. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The student's legal first name (OneRoster given name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The student's legal last/surname (OneRoster family name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "middleName": {
            "type": "string",
            "maxLength": 256,
            "description": "The student's middle name, if any. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "generationCodeSuffix": {
            "type": "string",
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III)."
          },
          "maidenName": {
            "type": "string",
            "maxLength": 75,
            "description": "The student's maiden name, if applicable."
          },
          "personalTitlePrefix": {
            "type": "string",
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the student."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student was born."
          },
          "birthCity": {
            "type": "string",
            "maxLength": 30,
            "description": "The city the student was born in."
          },
          "birthStateAbbreviationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The abbreviation for the name of the state (within the United States) or extra-state jurisdiction in which the student was born."
          },
          "birthInternationalProvince": {
            "type": "string",
            "maxLength": 150,
            "description": "For students born outside of the U.S., the Province or jurisdiction in which the student was born."
          },
          "birthCountryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The country in which the student was born."
          },
          "dateEnteredUS": {
            "type": "string",
            "format": "date",
            "description": "For students born outside of the U.S., the date the student entered the U.S."
          },
          "multipleBirthStatus": {
            "type": "boolean",
            "description": "Indicator of whether the student was born with other babies as part of a multiple birth."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The student's birth sex as reported to the education organization."
          },
          "citizenshipStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indicator of whether or not the student is a U.S. citizen."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic attributed to the student."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or became inactive."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to the student (e.g., homeless, migrant, immigrant, displaced homemaker), with optional effective date range. Items unique by (studentCharacteristicDescriptor)."
          },
          "cohortYears": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "cohortYearTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of cohort year (e.g., Ninth grade, Expected graduation)."
                },
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "The school year associated with this cohort designation."
                }
              },
              "required": [
                "cohortYearTypeDescriptor",
                "schoolYear"
              ]
            },
            "description": "A cohort year classification for the student, indicating the school year cohort the student entered or is expected to graduate from. Items unique by (cohortYearTypeDescriptor, schoolYear)."
          },
          "disabilityDesignations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A disability category to which the student belongs."
                },
                "disabilityDesignationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The specific designation (e.g., Section 504 Coverage, IDEA Part B Eligible)."
                }
              },
              "required": [
                "disabilityDescriptor",
                "disabilityDesignationDescriptor"
              ]
            },
            "description": "A disability designation for a student, providing the specific designation associated with a disability descriptor (e.g., IDEA qualification, 504 plan). Items unique by (disabilityDescriptor, disabilityDesignationDescriptor)."
          },
          "educationPlans": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationPlanTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of education plan (e.g., IEP, 504 Plan, Gifted and Talented)."
                }
              },
              "required": [
                "educationPlanTypeDescriptor"
              ]
            },
            "description": "An education plan assigned to the student (e.g., IEP, 504 Plan, Career Pathway). Items unique by (educationPlanTypeDescriptor)."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the student."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the student."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a student, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress)."
          },
          "identificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to verify a student's identity, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "indicators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "description": "The name of the indicator or metric."
                },
                "indicator": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The value of the indicator or metric."
                },
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 200,
                  "description": "The name for a group of indicators."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the indicator was assigned to the student."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the indicator was removed."
                }
              },
              "required": [
                "indicatorName"
              ]
            },
            "description": "A named indicator or metric associated with a student (e.g., at-risk, gifted and talented), with optional effective date range. Items unique by (indicatorName)."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a student, discriminated by address type. Items unique by (addressTypeDescriptor)."
          },
          "migrantEducationProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "migrantEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The migrant education program service provided to the student."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if this is the primary service being provided to the migrant student."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student began receiving this service."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student received this service."
                }
              },
              "required": [
                "migrantEducationProgramServiceDescriptor"
              ]
            },
            "description": "A migrant education program service provided to the student, discriminated by service descriptor. Items unique by (migrantEducationProgramServiceDescriptor)."
          },
          "otherNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a student (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The student's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The student's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The student's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the student is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor)."
          },
          "personalIdentificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document presented by the student for identity verification purposes, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "visas": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "visaDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An indicator of a non-U.S. citizen's Visa type."
                }
              },
              "required": [
                "visaDescriptor"
              ]
            },
            "description": "A visa type associated with a student, indicating immigration/residency documentation. Items unique by (visaDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "firstName",
          "lastSurname",
          "birthDate",
          "recordState",
          "dateLastModified"
        ]
      },
      "StudentAcademicRecord": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationId, schoolYear, termDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to the education organization."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year for which this academic record applies."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term for the session during the school year (e.g., Fall Semester, Spring Semester)."
          },
          "cumulativeEarnedCredits": {
            "type": "number",
            "description": "The cumulative number of credits an individual earns by completing courses or examinations during or before the term."
          },
          "cumulativeEarnedCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credits or units of value awarded for the completion of a course."
          },
          "cumulativeAttemptedCredits": {
            "type": "number",
            "description": "The cumulative number of credits an individual attempts to earn."
          },
          "cumulativeAttemptedCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credit attempted."
          },
          "cumulativeGradePointsEarned": {
            "type": "number",
            "description": "The cumulative number of grade points an individual earns."
          },
          "cumulativeGradePointAverage": {
            "type": "number",
            "description": "The cumulative grade point average."
          },
          "gradeValueQualifier": {
            "type": "string",
            "maxLength": 80,
            "description": "The scale of equivalents used in determining the grade value."
          },
          "projectedGraduationDate": {
            "type": "string",
            "format": "date",
            "description": "The projected date of graduation."
          },
          "sessionEarnedCredits": {
            "type": "number",
            "description": "Credits earned during this session."
          },
          "sessionEarnedCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credits earned during this session."
          },
          "sessionAttemptedCredits": {
            "type": "number",
            "description": "Credits attempted during this session."
          },
          "sessionAttemptedCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credits attempted during this session."
          },
          "sessionGradePointsEarned": {
            "type": "number",
            "description": "Grade points earned during this session."
          },
          "sessionGradePointAverage": {
            "type": "number",
            "description": "GPA for this session."
          },
          "contentGradePointAverage": {
            "type": "number",
            "description": "A measure of average performance for courses taken in a specific content area."
          },
          "contentGradePointEarned": {
            "type": "number",
            "description": "Grade points earned in a specific content area."
          },
          "academicHonors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicHonorCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of academic honor (e.g., Dean's List, Honor Roll, Valedictorian)."
                },
                "honorDescription": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 80,
                  "description": "A description of the type of academic distinctions earned by or awarded to the individual."
                },
                "honorAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the honor was awarded."
                },
                "honorAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the honor expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title assigned to the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement earned."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for earning the honor."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for the criteria details."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the agent that issued the honor."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuing organization."
                }
              },
              "required": [
                "academicHonorCategoryDescriptor",
                "honorDescription"
              ]
            },
            "description": "An academic honor or distinction earned by a student for a specific academic record period. Collection child of StudentAcademicRecord. Items unique by (academicHonorCategoryDescriptor, honorDescription)."
          },
          "classRanking": {
            "type": "object",
            "properties": {
              "classRank": {
                "type": "integer",
                "description": "The student's class rank within the education organization."
              },
              "totalNumberInClass": {
                "type": "integer",
                "description": "The total number of students in the class."
              },
              "percentageRanking": {
                "type": "number",
                "description": "The student's percentile ranking within the class."
              },
              "classRankingDate": {
                "type": "string",
                "format": "date",
                "description": "Date class ranking was determined."
              }
            },
            "required": [
              "classRank",
              "totalNumberInClass"
            ],
            "description": "A student's class ranking for a specific academic record period. Collection child of StudentAcademicRecord."
          },
          "creditsEarned": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "creditTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of credits (e.g., Carnegie unit, Semester hour)."
                },
                "credits": {
                  "type": "number",
                  "description": "The number of credits earned."
                }
              },
              "required": [
                "creditTypeDescriptor",
                "credits"
              ]
            },
            "description": "Credits earned by a student in a specific academic record period, categorized by credit type. Collection child of StudentAcademicRecord. Items unique by (creditTypeDescriptor)."
          },
          "diplomas": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "diplomaTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of diploma/credential earned (e.g., Regular diploma, Certificate of attendance)."
                },
                "diplomaAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which the student met graduation requirements."
                },
                "diplomaDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "The description of the diploma."
                },
                "diplomaLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The level of the diploma (e.g., honors, distinguished)."
                },
                "diplomaAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date the diploma award expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the achievement earned."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement."
                },
                "achievementCategorySystem": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The system that defines the category of achievement."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for earning the achievement."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for criteria details."
                },
                "evidenceStatement": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "A statement or reference describing the evidence."
                },
                "imageUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for image of the diploma/credential."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the entity that issued the credential."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuer."
                }
              },
              "required": [
                "diplomaTypeDescriptor",
                "diplomaAwardDate"
              ]
            },
            "description": "A diploma or credential awarded to a student. Links to the student via OneRoster roster foreign key. Items unique by (diplomaTypeDescriptor, diplomaAwardDate)."
          },
          "gradePointAverages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradePointAverageTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of GPA (e.g., Weighted, Unweighted, Cumulative)."
                },
                "gradePointAverageValue": {
                  "type": "number",
                  "description": "The GPA value."
                },
                "isCumulative": {
                  "type": "boolean",
                  "description": "Indicates whether this GPA is cumulative."
                },
                "maxGradePointAverageValue": {
                  "type": "number",
                  "description": "The maximum GPA value achievable on this scale."
                }
              },
              "required": [
                "gradePointAverageTypeDescriptor",
                "gradePointAverageValue"
              ]
            },
            "description": "A GPA calculation for a student academic record, keyed by GPA type. Collection child of StudentAcademicRecord. Items unique by (gradePointAverageTypeDescriptor)."
          },
          "recognitions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "recognitionTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of recognition awarded (e.g., Athletic, Attendance, Citizenship)."
                },
                "recognitionDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the recognition."
                },
                "recognitionAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition was awarded."
                },
                "recognitionAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for receiving this recognition."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for the criteria."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The organization that issued the recognition."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuer."
                }
              },
              "required": [
                "recognitionTypeDescriptor"
              ]
            },
            "description": "A recognition or award received by a student for a specific academic record period. Collection child of StudentAcademicRecord. Items unique by (recognitionTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this academic record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "schoolYear",
          "termDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentAssessment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, assessmentIdentifier, namespace, administrationDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who took this assessment (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Identifies the assessment that was administered."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment that was administered."
          },
          "administrationDate": {
            "type": "string",
            "format": "date",
            "description": "The date the assessment was administered to the student."
          },
          "administrationEndDate": {
            "type": "string",
            "format": "date",
            "description": "The date the assessment administration ended, if different from the start."
          },
          "serialNumber": {
            "type": "string",
            "maxLength": 60,
            "description": "The unique number for the assessment form or answer document."
          },
          "administrationLanguageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The language in which the assessment was administered."
          },
          "administrationEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The environment in which the assessment was administered (e.g., classroom, lab)."
          },
          "retestIndicatorDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Indicator of whether the student is retesting."
          },
          "reasonNotTestedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The primary reason student is not tested."
          },
          "whenAssessedGradeLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The grade level of the student when assessed."
          },
          "eventCircumstanceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An unusual event that occurred during the assessment."
          },
          "eventDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Describes an unusual event that occurred during the assessment."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code of the assessment item."
                },
                "assessmentItemResultDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The result of the student's response (e.g., Correct, Incorrect, Not Attempted)."
                },
                "assessmentResponse": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The student's response to the assessment item."
                },
                "descriptiveFeedback": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Descriptive feedback or comments about the student's response."
                },
                "rawScoreResult": {
                  "type": "number",
                  "description": "The raw score earned on this assessment item."
                },
                "timeAssessed": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The time spent on this assessment item."
                }
              },
              "required": [
                "identificationCode"
              ]
            },
            "description": "A student's response and result for an individual assessment item. Collection child of StudentAssessment, keyed on the student assessment's natural key plus the item identification code. Items unique by (identificationCode)."
          },
          "performanceLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level achieved (e.g., Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this performance level."
                },
                "performanceLevelMet": {
                  "type": "boolean",
                  "description": "Indicates whether the student met this performance level."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level achieved by a student on an assessment. Collection child of StudentAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "scoreResults": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this score (e.g., Scale score, Raw score, Percentile)."
                },
                "result": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 35,
                  "description": "The value of the score result."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The datatype of the result (e.g., Integer, Decimal, Level)."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor",
                "result",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "A score result from a student's assessment event, keyed by reporting method. Collection child of StudentAssessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "studentObjectiveAssessments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "objectiveAssessmentIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code of the objective assessment being reported on."
                },
                "performanceLevels": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "performanceLevelDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The performance level achieved."
                      },
                      "assessmentReportingMethodDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The reporting method for this performance level."
                      },
                      "performanceLevelMet": {
                        "type": "boolean",
                        "description": "Indicates whether the performance level was met."
                      }
                    },
                    "required": [
                      "performanceLevelDescriptor",
                      "assessmentReportingMethodDescriptor"
                    ]
                  },
                  "description": "A performance level achieved by a student on an objective assessment. Collection child of StudentAssessmentStudentObjectiveAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
                },
                "scoreResults": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "assessmentReportingMethodDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The reporting method for this score."
                      },
                      "result": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 35,
                        "description": "The value of the score result."
                      },
                      "resultDatatypeTypeDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The datatype of the result."
                      }
                    },
                    "required": [
                      "assessmentReportingMethodDescriptor",
                      "result",
                      "resultDatatypeTypeDescriptor"
                    ]
                  },
                  "description": "A score result for a student's performance on an objective assessment within a student assessment event. Collection child of StudentAssessmentStudentObjectiveAssessment. Items unique by (assessmentReportingMethodDescriptor)."
                }
              },
              "required": [
                "objectiveAssessmentIdentificationCode"
              ]
            },
            "description": "A student's performance on an objective assessment within a student assessment event. Collection child of StudentAssessment, capturing per-objective results. Items unique by (objectiveAssessmentIdentificationCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentAssessmentEducationOrganizationAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, assessmentIdentifier, namespace, administrationDate, educationOrganizationSourcedId, educationOrganizationAssociationTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student assessment natural-key student leg.",
            "x-references": "studentAssessment.studentSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationDate"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the student assessment."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the student assessment."
          },
          "administrationDate": {
            "type": "string",
            "format": "date",
            "description": "Administration date of the student assessment."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the student assessment results. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationAssociationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of association being represented."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with the association."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationDate",
          "educationOrganizationSourcedId",
          "educationOrganizationAssociationTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentAssessmentRegistration": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assigningEducationOrganizationSourcedId, assessmentIdentifier, namespace, administrationIdentifier, studentSourcedId, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assigning education organization of the assessment administration (oneroster:org sourcedId; matches assessmentAdministration natural-key leg).",
            "x-references": "assessmentAdministration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the administration."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assessment namespace of the administration."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the demographic context (also roster-anchored via studentDemographic → oneroster:user).",
            "x-references": "studentDemographic.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the demographic context (leg of studentDemographic natural key; oneroster:org sourcedId)."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the attending studentSchoolAssociation (studentSourcedId + schoolSourcedId + entryDate). Roster FK to oneroster:org; association integrity enforced at command layer.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "entryDate": {
            "type": "string",
            "format": "date",
            "description": "Entry date of the attending studentSchoolAssociation."
          },
          "reportingEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Education organization which should receive the results. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "testingEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Education organization expected to administer the assessment. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentGradeLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Grade level at which the student is to be assessed."
          },
          "platformTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Environment or format for administration."
          },
          "scheduledAccommodationStudentSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional scheduled general accommodation student leg.",
            "x-references": "studentEducationOrganizationAssessmentAccommodation.studentSourcedId",
            "x-references-legs": [
              "scheduledAccommodationEducationOrganizationSourcedId"
            ],
            "x-onDelete": "restrict"
          },
          "scheduledAccommodationEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional scheduled general accommodation education organization leg."
          },
          "assessmentAccommodations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Assessment accommodation."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "assessmentAccommodationsItem value."
            },
            "description": "Assessment accommodations for this registration."
          },
          "assessmentCustomizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "customizationKey": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Customization key."
                },
                "customizationValue": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Customization value."
                }
              },
              "required": [
                "customizationKey",
                "customizationValue"
              ],
              "description": "assessmentCustomizationsItem value."
            },
            "description": "Key/value customization pairs."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assigningEducationOrganizationSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationIdentifier",
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "schoolSourcedId",
          "entryDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentAssessmentRegistrationBatteryPartAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, assigningEducationOrganizationSourcedId, assessmentIdentifier, namespace, administrationIdentifier, studentSourcedId, educationOrganizationSourcedId, assessmentBatteryPartName). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assigning education organization of the registration.",
            "x-references": "studentAssessmentRegistration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier",
              "studentSourcedId",
              "educationOrganizationSourcedId"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier shared with the registration and the assessmentBatteryPart natural key (assessmentIdentifier + namespace + assessmentBatteryPartName).",
            "x-references": "assessmentBatteryPart.assessmentIdentifier",
            "x-references-legs": [
              "namespace",
              "assessmentBatteryPartName"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assessment namespace."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the registration."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the registration demographic context."
          },
          "assessmentBatteryPartName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Battery part name (third leg of assessmentBatteryPart natural key; FK declared on assessmentIdentifier)."
          },
          "accommodations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Accommodation for this battery part."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "accommodationsItem value."
            },
            "description": "Accommodations for the specific battery part."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "assigningEducationOrganizationSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationIdentifier",
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "assessmentBatteryPartName",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentCTEProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "nonTraditionalGenderStatus": {
            "type": "boolean",
            "description": "Indicator that student is from a gender group that comprises less than 25% of the individuals employed in an occupation or field of work."
          },
          "privateCTEProgram": {
            "type": "boolean",
            "description": "Indicator that student participated in career and technical education at private agencies or institutions."
          },
          "technicalSkillsAssessmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Results of technical skills assessment aligned with industry recognized standards."
          },
          "cteProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "cteProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the CTE program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                },
                "cipCode": {
                  "type": "string",
                  "maxLength": 120,
                  "description": "CIP code associated with the CTE program service."
                }
              },
              "required": [
                "cteProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of cteProgramServiceDescriptor items. Items unique by (cteProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentCohortAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student assigned to the cohort.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined the cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student was assigned to the cohort."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student was removed from the cohort."
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The local identifier assigned to a section."
                },
                "sessionName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identifier for the calendar for the academic session (e.g., '2010/11 Semester 1')."
                }
              },
              "required": [
                "sectionIdentifier",
                "sessionName"
              ]
            },
            "description": "The cohort's associated section(s). A multi-valued collection child of StudentCohortAssociation keyed by the parent's natural key plus the sectionIdentifier and sessionName discriminators. Items unique by (sectionIdentifier, sessionName)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student cohort association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "cohortIdentifier",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentCompetencyObjective": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, objectiveSchoolSourcedId, objective, objectiveGradeLevelDescriptor, gradingPeriodSchoolSourcedId, gradingPeriodDescriptor, periodSequence, schoolYear). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "objectiveSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the competency objective (competencyObjective natural key schoolSourcedId).",
            "x-references": "competencyObjective.schoolSourcedId",
            "x-references-legs": [
              "objective",
              "objectiveGradeLevelDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "objective": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Competency objective title (leg of competencyObjective natural key)."
          },
          "objectiveGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Grade level of the competency objective."
          },
          "gradingPeriodSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the grading period.",
            "x-references": "gradingPeriod.schoolSourcedId",
            "x-references-legs": [
              "gradingPeriodDescriptor",
              "periodSequence",
              "schoolYear"
            ],
            "x-onDelete": "restrict"
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Grading period descriptor."
          },
          "periodSequence": {
            "type": "integer",
            "description": "Grading period sequence."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "School year."
          },
          "competencyLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Competency level assessed."
          },
          "diagnosticStatement": {
            "type": "string",
            "maxLength": 1024,
            "description": "Teacher diagnostic statement."
          },
          "studentSectionAssociations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "schoolSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Section school."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Local course code."
                },
                "schoolYear": {
                  "type": "integer",
                  "description": "School year."
                },
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term."
                },
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Section identifier."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Section association begin date."
                }
              },
              "required": [
                "schoolSourcedId",
                "localCourseCode",
                "schoolYear",
                "termDescriptor",
                "sectionIdentifier",
                "beginDate"
              ],
              "description": "studentSectionAssociationsItem value."
            },
            "description": "Optional related student section associations (choice arm). Nested association integrity enforced at command layer."
          },
          "generalStudentProgramAssociations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student."
                },
                "programEducationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Program education organization."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Program name."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Program type."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Program association begin date."
                }
              },
              "required": [
                "studentSourcedId",
                "programEducationOrganizationSourcedId",
                "programName",
                "programTypeDescriptor",
                "beginDate"
              ],
              "description": "generalStudentProgramAssociationsItem value."
            },
            "description": "Optional related general student program associations (choice arm). Nested association integrity enforced at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "objectiveSchoolSourcedId",
          "objective",
          "objectiveGradeLevelDescriptor",
          "gradingPeriodSchoolSourcedId",
          "gradingPeriodDescriptor",
          "periodSequence",
          "schoolYear",
          "competencyLevelDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentContactAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, contactUniqueId).",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student in this association. Cross-module roster FK.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The contact's unique identifier. Intra-domain FK to the Contact entity.",
            "x-references": "contact.contactUniqueId",
            "x-onDelete": "cascade"
          },
          "relationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The nature of an individual's relationship to a student (e.g., Father, Mother, Step Father, Guardian)."
          },
          "primaryContactStatus": {
            "type": "boolean",
            "description": "Indicator of whether the person is a primary contactal contact for the student."
          },
          "livesWith": {
            "type": "boolean",
            "description": "Indicator of whether the student lives with the associated contact."
          },
          "emergencyContactStatus": {
            "type": "boolean",
            "description": "Indicator of whether the person is a designated emergency contact for the student."
          },
          "contactPriority": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric order of the preferred sequence of contact."
          },
          "contactRestrictions": {
            "type": "string",
            "maxLength": 250,
            "description": "Restrictions for student and/or teacher contact with the individual (e.g., No contact, Restraining order)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "contactUniqueId",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentDemographic": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context for these demographics.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The student's birth sex."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "The student's gender identity as last reported."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "economicDisadvantageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Economic disadvantage indicator."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Limited English proficiency indicator."
          },
          "supporterMilitaryConnectionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Military connection of the person the student is a dependent of."
          },
          "citizenship": {
            "type": "object",
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation for the individual."
          },
          "ancestryEthnicOrigins": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ancestryEthnicOriginDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Ancestry ethnic origin."
                }
              },
              "required": [
                "ancestryEthnicOriginDescriptor"
              ],
              "description": "ancestryEthnicOriginsItem value."
            },
            "description": "Ancestry ethnic origins."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race category."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race categories."
          },
          "tribalAffiliations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Tribal affiliation."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ],
              "description": "tribalAffiliationsItem value."
            },
            "description": "Tribal affiliations."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages the student uses."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "studentCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Student characteristic."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Who designated the characteristic."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ],
              "description": "studentCharacteristicsItem value."
            },
            "description": "Student characteristics."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentDirectory": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The email address."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Priority order of this number."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentDisciplineIncidentBehaviorAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, schoolSourcedId, incidentIdentifier, behaviorDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student associated with the behavior (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify the DisciplineIncident."
          },
          "behaviorDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Describes behavior by category and provides a detailed description."
          },
          "behaviorDetailedDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Specifies a more granular level of detail of a behavior involved in the incident."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "incidentIdentifier",
          "behaviorDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentDisciplineIncidentNonOffenderAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, schoolSourcedId, incidentIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the non-offending student associated with the discipline incident (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify the DisciplineIncident."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "incidentIdentifier",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentEducationOrganizationAssessmentAccommodation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization determining accommodations.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "generalAccommodations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "General assessment accommodation."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "generalAccommodationsItem value."
            },
            "description": "Special variations for how assessments are presented or administered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentEducationOrganizationAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student whose demographics are reported in this education organization context.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization reporting the student's demographic information.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A person's gender."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication that the student has been identified as limited English proficient by the Language Proficiency Assessment Committee (LPAC), or equivalent combinating, as specified by each state."
          },
          "oldEthnicityDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Previous definition of ethnicity combining combinating race and ethnicity into a single concept."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central, and South America, and other Spanish cultures, regardless of race. The term 'Spanish combinating origin' can be used in addition to 'Hispanic or Latino'."
          },
          "profileThumbnail": {
            "type": "string",
            "maxLength": 2048,
            "description": "URL or reference to a profile thumbnail image for the student in this education organization context."
          },
          "loginId": {
            "type": "string",
            "maxLength": 60,
            "description": "The login ID for the user; the credentials for the user to gain access to the system."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address listed for an individual (e.g., Physical, Mailing, Home, etc.)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number of an address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which an address is located."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which an address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of local government of an address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which an address is located."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ]
            },
            "description": "The set of elements that describes an address, including the street address, city, state, and ZIP code, associated with a student in the context of an education organization. A multi-valued collection child of StudentEducationOrganizationAssociation keyed by the parent's natural key plus the address type descriptor discriminator. Items unique by (addressTypeDescriptor)."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A disability category that describes a child's impairment."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the disability diagnosis."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order by severity of student's disabilities: 1- Primary, 2 -Secondary, 3 - Tertiary, etc."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The source that provided the disability determination."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "The disability condition(s) that best describes an individual's impairment in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the disability descriptor discriminator. Items unique by (disabilityDescriptor)."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email listed for an individual (e.g., Home/Personal, Work, Other)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address listed for an individual."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for an individual."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic email address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "The set of elements that describes an electronic mail address associated with a student in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the electronic mail type descriptor discriminator. Items unique by (electronicMailTypeDescriptor)."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which written or spoken communication is being used."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "The language(s) the individual uses to communicate in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the language descriptor discriminator. Items unique by (languageDescriptor)."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category (e.g., American Indian or Alaska Native, Asian, Black or African American, Native Hawaiian or Other Pacific Islander, White)."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "The general racial category which most clearly reflects the individual's recognition of his or her community or with which the individual most identifies in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the race descriptor discriminator. Items unique by (raceDescriptor)."
          },
          "studentCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic designated for the student (e.g., Homeless, Migrant, Immigrant, Foster Care, etc.)."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ]
            },
            "description": "Reflects important characteristics of a student in the context of an education organization. If the student characteristic is time-sensitive, a begin/end date pair can be specified. A multi-valued collection child keyed by the parent's natural key plus the student characteristic descriptor discriminator. Items unique by (studentCharacteristicDescriptor)."
          },
          "studentIdentificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The organization code or name assigning the student identification code."
                },
                "studentIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to a student by a school, school system, a state, or other agency or entity."
                }
              },
              "required": [
                "assigningOrganizationIdentificationCode",
                "studentIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to a student in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the assigning organization identification code and the student identification system descriptor discriminators. Items unique by (assigningOrganizationIdentificationCode, studentIdentificationSystemDescriptor)."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of communication number listed for an individual (e.g., Home, Work, Mobile, etc.)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code, and extension, if applicable."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "The set of elements that describes a telephone number associated with a student in the context of an education organization. A multi-valued collection child of StudentEducationOrganizationAssociation keyed by the parent's natural key plus the telephone number type descriptor discriminator. Items unique by (telephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "sexDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentEducationOrganizationResponsibilityAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, responsibilityDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student for whom the education organization has a responsibility relationship.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization that has responsibility for the student.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "responsibilityDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Indications of an education organization's responsibility for a student (e.g., accountability, attendance, funding)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the education organization assumed responsibility for the student."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the education organization's responsibility for the student ended."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "responsibilityDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentExtension": {
        "type": "object",
        "properties": {
          "userSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Shared natural id with the OneRoster user this student extension belongs to 1:1. FK CASCADE so deleting the user reaps the companion.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "cascade"
          },
          "generationCodeSuffix": {
            "type": "string",
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III)."
          },
          "maidenName": {
            "type": "string",
            "maxLength": 75,
            "description": "The student's maiden name, if applicable."
          },
          "personalTitlePrefix": {
            "type": "string",
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the student."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student was born."
          },
          "birthCity": {
            "type": "string",
            "maxLength": 30,
            "description": "The city the student was born in."
          },
          "birthStateAbbreviationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The abbreviation for the name of the state (within the United States) or extra-state jurisdiction in which the student was born."
          },
          "birthInternationalProvince": {
            "type": "string",
            "maxLength": 150,
            "description": "For students born outside of the U.S., the Province or jurisdiction in which the student was born."
          },
          "birthCountryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The country in which the student was born."
          },
          "dateEnteredUS": {
            "type": "string",
            "format": "date",
            "description": "For students born outside of the U.S., the date the student entered the U.S."
          },
          "multipleBirthStatus": {
            "type": "boolean",
            "description": "Indicator of whether the student was born with other babies as part of a multiple birth."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The student's birth sex as reported to the education organization."
          },
          "citizenshipStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indicator of whether or not the student is a U.S. citizen."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic attributed to the student."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or became inactive."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to the student (e.g., homeless, migrant, immigrant, displaced homemaker), with optional effective date range. Items unique by (studentCharacteristicDescriptor)."
          },
          "cohortYears": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "cohortYearTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of cohort year (e.g., Ninth grade, Expected graduation)."
                },
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "The school year associated with this cohort designation."
                }
              },
              "required": [
                "cohortYearTypeDescriptor",
                "schoolYear"
              ]
            },
            "description": "A cohort year classification for the student, indicating the school year cohort the student entered or is expected to graduate from. Items unique by (cohortYearTypeDescriptor, schoolYear)."
          },
          "disabilityDesignations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A disability category to which the student belongs."
                },
                "disabilityDesignationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The specific designation (e.g., Section 504 Coverage, IDEA Part B Eligible)."
                }
              },
              "required": [
                "disabilityDescriptor",
                "disabilityDesignationDescriptor"
              ]
            },
            "description": "A disability designation for a student, providing the specific designation associated with a disability descriptor (e.g., IDEA qualification, 504 plan). Items unique by (disabilityDescriptor, disabilityDesignationDescriptor)."
          },
          "educationPlans": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationPlanTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of education plan (e.g., IEP, 504 Plan, Gifted and Talented)."
                }
              },
              "required": [
                "educationPlanTypeDescriptor"
              ]
            },
            "description": "An education plan assigned to the student (e.g., IEP, 504 Plan, Career Pathway). Items unique by (educationPlanTypeDescriptor)."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the student."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the student."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a student, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress)."
          },
          "identificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to verify a student's identity, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "indicators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "description": "The name of the indicator or metric."
                },
                "indicator": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The value of the indicator or metric."
                },
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 200,
                  "description": "The name for a group of indicators."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the indicator was assigned to the student."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the indicator was removed."
                }
              },
              "required": [
                "indicatorName"
              ]
            },
            "description": "A named indicator or metric associated with a student (e.g., at-risk, gifted and talented), with optional effective date range. Items unique by (indicatorName)."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a student, discriminated by address type. Items unique by (addressTypeDescriptor)."
          },
          "migrantEducationProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "migrantEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The migrant education program service provided to the student."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if this is the primary service being provided to the migrant student."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student began receiving this service."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student received this service."
                }
              },
              "required": [
                "migrantEducationProgramServiceDescriptor"
              ]
            },
            "description": "A migrant education program service provided to the student, discriminated by service descriptor. Items unique by (migrantEducationProgramServiceDescriptor)."
          },
          "otherNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a student (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The student's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The student's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The student's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the student is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor)."
          },
          "personalIdentificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document presented by the student for identity verification purposes, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "visas": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "visaDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An indicator of a non-U.S. citizen's Visa type."
                }
              },
              "required": [
                "visaDescriptor"
              ]
            },
            "description": "A visa type associated with a student, indicating immigration/residency documentation. Items unique by (visaDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        },
        "required": [
          "userSourcedId"
        ]
      },
      "StudentGradebookEntry": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, gradebookEntryIdentifier, namespace, studentSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "gradebookEntryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Gradebook entry identifier.",
            "x-references": "gradebookEntry.gradebookEntryIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the gradebook entry."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "competencyLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Competency level assessed."
          },
          "dateFulfilled": {
            "type": "string",
            "format": "date",
            "description": "The date an assignment was turned in."
          },
          "timeFulfilled": {
            "type": "string",
            "format": "time",
            "description": "The time an assignment was turned in."
          },
          "diagnosticStatement": {
            "type": "string",
            "maxLength": 1024,
            "description": "Teacher diagnostic statement."
          },
          "pointsEarned": {
            "type": "number",
            "description": "Points earned for the submission."
          },
          "letterGradeEarned": {
            "type": "string",
            "maxLength": 20,
            "description": "Letter grade earned."
          },
          "numericGradeEarned": {
            "type": "number",
            "description": "Numeric grade earned."
          },
          "submissionStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Submission status."
          },
          "assignmentLateStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Late status of the assignment."
          },
          "dateCompleted": {
            "type": "string",
            "format": "date",
            "description": "The date the assignment was completed."
          },
          "assignmentPassed": {
            "type": "boolean",
            "description": "Whether the assignment was passed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "gradebookEntryIdentifier",
          "namespace",
          "studentSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentHealth": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId).",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whom the health information relates to.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The educational organization accountable for a student's health information.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "Date of last update of the student's health record."
          },
          "requiredImmunizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "immunizationTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of required immunization."
                },
                "dates": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "immunizationDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date the immunization was received."
                      }
                    },
                    "required": [
                      "immunizationDate"
                    ]
                  },
                  "description": "Dates the immunization was received."
                },
                "medicalExemption": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Medical exemption explanation."
                },
                "medicalExemptionDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date of the medical exemption."
                }
              },
              "required": [
                "immunizationTypeDescriptor"
              ]
            },
            "description": "Required immunizations. Folded Common collection. Items unique by (immunizationTypeDescriptor)."
          },
          "additionalImmunizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "immunizationName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "Name of the additional immunization."
                },
                "dates": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "immunizationDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date the immunization was received."
                      }
                    },
                    "required": [
                      "immunizationDate"
                    ]
                  },
                  "description": "Dates the immunization was received."
                }
              },
              "required": [
                "immunizationName"
              ]
            },
            "description": "Additional immunizations. Folded Common collection. Items unique by (immunizationName)."
          },
          "nonMedicalImmunizationExemptionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of nonmedical exemption from vaccination claimed by the student's parent or guardian."
          },
          "nonMedicalImmunizationExemptionDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the nonmedical exemption from vaccination."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "asOfDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentHomelessProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "homelessPrimaryNighttimeResidenceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The primary nighttime residence of the student at the time the student is identified as homeless."
          },
          "awaitingFosterCare": {
            "type": "boolean",
            "description": "State defined definition for awaiting foster care."
          },
          "homelessUnaccompaniedYouth": {
            "type": "boolean",
            "description": "A homeless unaccompanied youth is a youth who is not in the physical custody of a parent or guardian and who fits the McKinney-Vento definition of homeless."
          },
          "homelessProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "homelessProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the homeless program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "homelessProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of homelessProgramServiceDescriptor items. Items unique by (homelessProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentIdentificationCode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student this identification code belongs to (references the oneroster:user record backing edfi:student).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "cascade"
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The organization code or name assigning the student identification code."
          },
          "studentIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a student by a school, school system, state, or other agency or entity."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "assigningOrganizationIdentificationCode",
          "studentIdentificationSystemDescriptor",
          "identificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentIep": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, studentIepIdentifier, iepFinalizedDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the IEP.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the student IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "The date the IEP was finalized."
          },
          "iepBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the IEP."
          },
          "iepEndDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the IEP."
          },
          "iepStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The status of the IEP."
          },
          "accommodations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Accommodation provided under the IEP."
                }
              },
              "required": [
                "accommodationDescriptor"
              ]
            },
            "description": "Accommodations associated with the IEP."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "Disability conditions."
          },
          "ideaEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "iepAmendedDate": {
            "type": "string",
            "format": "date",
            "description": "The date the IEP was amended."
          },
          "medicallyFragile": {
            "type": "boolean",
            "description": "Indicates whether the student is medically fragile."
          },
          "multiplyDisabled": {
            "type": "boolean",
            "description": "Indicates whether the student is multiply disabled."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student exited the IEP."
          },
          "schoolHoursPerWeek": {
            "type": "number",
            "description": "School hours per week."
          },
          "specialEducationHoursPerWeek": {
            "type": "number",
            "description": "Special education hours per week."
          },
          "specialEducationSettingDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The special education setting."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "studentIepIdentifier",
          "iepFinalizedDate",
          "iepBeginDate",
          "iepEndDate",
          "iepStatusDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentIepGoal": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, studentIepIdentifier, iepFinalizedDate, iepGoalIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "iepGoalIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the IEP goal."
          },
          "iepGoalDetails": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Details of the IEP goal."
          },
          "iepGoalTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of IEP goal."
          },
          "achievementPeriod": {
            "type": "object",
            "properties": {
              "beginDate": {
                "type": "string",
                "format": "date",
                "description": "Achievement period begin date."
              },
              "endDate": {
                "type": "string",
                "format": "date",
                "description": "Achievement period end date."
              }
            },
            "description": "The achievement period for the goal."
          },
          "ideaEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "studentIepIdentifier",
          "iepFinalizedDate",
          "iepGoalIdentifier",
          "iepGoalDetails",
          "iepGoalTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentIepServiceDelivery": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, studentIepIdentifier, iepFinalizedDate, iepServiceDeliveryIdentifier, serviceDeliveryDescriptor, serviceDeliveryDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "iepServiceDeliveryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the service delivery."
          },
          "serviceDeliveryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The service delivered."
          },
          "serviceDeliveryDate": {
            "type": "string",
            "format": "date",
            "description": "The date the service was delivered."
          },
          "ideaEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "providers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Provider first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Provider last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Provider middle name."
                },
                "primaryProvider": {
                  "type": "boolean",
                  "description": "Whether this is the primary provider."
                },
                "providerCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Provider code."
                },
                "serviceProviderTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Type of service provider."
                },
                "staffSourcedId": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "Optional staff sourcedId."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Providers who delivered the service."
          },
          "servicePrescriptionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional parent service prescription descriptor (command-layer validated)."
          },
          "servicePrescriptionDate": {
            "type": "string",
            "format": "date",
            "description": "Optional parent service prescription date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "studentIepIdentifier",
          "iepFinalizedDate",
          "iepServiceDeliveryIdentifier",
          "serviceDeliveryDescriptor",
          "serviceDeliveryDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentIepServicePrescription": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, studentIepIdentifier, iepFinalizedDate, servicePrescriptionDescriptor, servicePrescriptionDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "servicePrescriptionDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The prescribed service."
          },
          "servicePrescriptionDate": {
            "type": "string",
            "format": "date",
            "description": "The date the service was prescribed."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Service prescription begin date."
          },
          "duration": {
            "type": "integer",
            "description": "Duration of each service delivery."
          },
          "durationIntervalDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Interval unit for duration."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Service prescription end date."
          },
          "frequency": {
            "type": "number",
            "description": "Frequency of the service."
          },
          "frequencyIntervalDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Interval unit for frequency."
          },
          "serviceLocationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Where the service is delivered."
          },
          "ideaEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "staffs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "staffSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Staff member associated with the prescription."
                }
              },
              "required": [
                "staffSourcedId"
              ]
            },
            "description": "Staff associated with the service prescription (natural-key stubs)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "studentIepIdentifier",
          "iepFinalizedDate",
          "servicePrescriptionDescriptor",
          "servicePrescriptionDate",
          "beginDate",
          "duration",
          "durationIntervalDescriptor",
          "frequency",
          "frequencyIntervalDescriptor",
          "serviceLocationTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentInterventionAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student participating in the intervention.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "dosage": {
            "type": "integer",
            "description": "The duration in minutes of the intervention."
          },
          "diagnosticStatement": {
            "type": "string",
            "maxLength": 1024,
            "description": "A diagnostic statement describing the student's need for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student intervention association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "interventionIdentificationCode",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentInterventionAttendanceEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student whose attendance is recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence)."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "The reported reason for a student's absence or tardy."
          },
          "eventDuration": {
            "type": "number",
            "description": "The amount of time in hours for the attendance event."
          },
          "interventionDuration": {
            "type": "integer",
            "description": "The duration in minutes of the intervention session."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student intervention attendance event record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "interventionIdentificationCode",
          "eventDate",
          "attendanceEventCategoryDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentLanguageInstructionProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "englishLearnerParticipation": {
            "type": "boolean",
            "description": "An indication that an English learner student is served by an English language instruction educational program supported with Title III of ESEA funds."
          },
          "dosage": {
            "type": "integer",
            "description": "The duration of time in minutes for which the student was assigned to participate in the program."
          },
          "englishLanguageProficiencyAssessments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "School year of the English language proficiency assessment."
                },
                "participationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Participation result."
                },
                "proficiencyDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Proficiency result."
                },
                "progressDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Progress result."
                },
                "monitoredDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Monitored status."
                }
              },
              "required": [
                "schoolYear"
              ]
            },
            "description": "Results of yearly English language assessment. Folded Common collection. Items unique by (schoolYear)."
          },
          "languageInstructionProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageInstructionProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the language instruction program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "languageInstructionProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of languageInstructionProgramServiceDescriptor items. Items unique by (languageInstructionProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentMigrantEducationProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "priorityForServices": {
            "type": "boolean",
            "description": "Report migratory children who are classified as having priority for services."
          },
          "lastQualifyingMove": {
            "type": "string",
            "format": "date",
            "description": "Date the last qualifying move occurred; used to compute MEP status."
          },
          "continuationOfServicesReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The continuation of services provision reason."
          },
          "usInitialEntry": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student first entered the U.S."
          },
          "usMostRecentEntry": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year of the student's most recent entry into the U.S."
          },
          "usInitialSchoolEntry": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student first entered a U.S. school."
          },
          "qualifyingArrivalDate": {
            "type": "string",
            "format": "date",
            "description": "The qualifying arrival date (QAD)."
          },
          "stateResidencyDate": {
            "type": "string",
            "format": "date",
            "description": "The verified state residency for the student."
          },
          "eligibilityExpirationDate": {
            "type": "string",
            "format": "date",
            "description": "The eligibility expiration date used to determine end of eligibility."
          },
          "migrantEducationProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "migrantEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the migrant education program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "migrantEducationProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of migrantEducationProgramServiceDescriptor items. Items unique by (migrantEducationProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "priorityForServices",
          "lastQualifyingMove",
          "updatedAt"
        ]
      },
      "StudentNeglectedOrDelinquentProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "neglectedOrDelinquentProgramDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of program under ESEA Title I, Part D, Subpart 1 (state programs) or Subpart 2 (LEA)."
          },
          "elaProgressLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The progress measured from pre- to post- test for ELA."
          },
          "mathematicsProgressLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The progress measured from pre- to post-test for Mathematics."
          },
          "neglectedOrDelinquentProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "neglectedOrDelinquentProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the neglected or delinquent program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "neglectedOrDelinquentProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of neglectedOrDelinquentProgramServiceDescriptor items. Items unique by (neglectedOrDelinquentProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentPath": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, pathName). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with the path. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the path. Part of Path natural key.",
            "x-references": "path.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Name of the path."
          },
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Effective date periods."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "pathName",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentPathMilestoneStatus": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, pathName, pathMilestoneName, pathMilestoneTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the parent StudentPath.",
            "x-references": "studentPath.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent StudentPath/Path."
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path name of the parent StudentPath."
          },
          "pathMilestoneName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Referenced path milestone name.",
            "x-references": "pathMilestone.pathMilestoneName",
            "x-references-legs": [
              "pathMilestoneTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "pathMilestoneTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Referenced path milestone type."
          },
          "completionIndicator": {
            "type": "boolean",
            "description": "Whether the milestone is complete."
          },
          "pathMilestoneStatusEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "pathMilestoneStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Milestone status."
                },
                "pathMilestoneStatusDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Status date."
                },
                "description": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Status event description."
                }
              },
              "required": [
                "pathMilestoneStatusDescriptor",
                "pathMilestoneStatusDate"
              ],
              "description": "pathMilestoneStatusEventsItem value."
            },
            "description": "Status events for this milestone (folded)."
          },
          "pathPhaseName": {
            "type": "string",
            "maxLength": 60,
            "description": "Optional path phase name within the same path."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "pathName",
          "pathMilestoneName",
          "pathMilestoneTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentPathPhaseStatus": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationSourcedId, pathName, pathPhaseName). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the parent StudentPath.",
            "x-references": "studentPath.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent path/phase.",
            "x-references": "pathPhase.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName",
              "pathPhaseName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path name."
          },
          "pathPhaseName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path phase name."
          },
          "completionIndicator": {
            "type": "boolean",
            "description": "Whether the phase is complete."
          },
          "pathPhaseStatusEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "pathPhaseStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Phase status."
                },
                "pathPhaseStatusDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Status date."
                }
              },
              "required": [
                "pathPhaseStatusDescriptor",
                "pathPhaseStatusDate"
              ],
              "description": "pathPhaseStatusEventsItem value."
            },
            "description": "Status events for this phase (folded)."
          },
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Effective date periods."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "pathName",
          "pathPhaseName",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for `{id}` wire routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student participating in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program. Typically, this is the date the student becomes eligible for the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's program participation over time. A multi-valued collection child of studentProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentProgramAttendanceEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, educationOrganizationId, programName, programTypeDescriptor, eventDate, attendanceEventCategoryDescriptor).",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with the attendance event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the program (and where the student is participating). Program natural-key leg; oneroster:org sourcedId.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the program."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the attendance event (e.g., In Attendance, Excused Absence)."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "The reported reason for a student's absence or tardy."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which a student receives education and related services."
          },
          "eventDuration": {
            "type": "number",
            "description": "The amount of time for the event as decimal hours."
          },
          "programAttendanceDuration": {
            "type": "integer",
            "description": "The duration in minutes of the program attendance event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "eventDate",
          "attendanceEventCategoryDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentProgramEvaluation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationId, programName, programTypeDescriptor, programEvaluationTitle, programEvaluationPeriodDescriptor, programEvaluationTypeDescriptor, studentSourcedId, evaluationDate).",
            "readOnly": true
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program evaluation (programEvaluation natural-key leg).",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Program name leg of the parent program evaluation."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Program type leg of the parent program evaluation."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title leg of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Period leg of the parent program evaluation."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type leg of the parent program evaluation."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student being evaluated on behalf of the program.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the evaluation was conducted."
          },
          "evaluatingEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Optional education organization that evaluated the student (may differ from the program's education organization).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationDuration": {
            "type": "integer",
            "description": "The actual number of minutes to conduct the evaluation."
          },
          "summaryEvaluationNumericRating": {
            "type": "number",
            "description": "The numerical summary rating or score for the evaluation."
          },
          "summaryEvaluationRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The summary rating level achieved based upon the rating or score."
          },
          "summaryEvaluationComment": {
            "type": "string",
            "maxLength": 1024,
            "description": "Any comments about the summary evaluation to be captured."
          },
          "staffEvaluatorStaffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Reference to the staff that evaluated the student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "externalEvaluators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "externalEvaluator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The external person that conducted the evaluation."
                }
              },
              "required": [
                "externalEvaluator"
              ]
            },
            "description": "External person(s) - not staff - that conducted the evaluation. Folded collection."
          },
          "studentEvaluationObjectives": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "programEvaluationObjectiveTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the program evaluation objective (discriminator within the parent evaluation)."
                },
                "evaluationObjectiveNumericRating": {
                  "type": "number",
                  "description": "Numeric rating for the objective."
                },
                "evaluationObjectiveRatingLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Rating level for the objective."
                }
              },
              "required": [
                "programEvaluationObjectiveTitle"
              ]
            },
            "description": "Student ratings for program evaluation objectives. Folded Common; objective title is the local discriminator (full objective FK validated at command layer)."
          },
          "studentEvaluationElements": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "programEvaluationElementTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the program evaluation element (discriminator within the parent evaluation)."
                },
                "evaluationElementNumericRating": {
                  "type": "number",
                  "description": "Numeric rating for the element."
                },
                "evaluationElementRatingLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Rating level for the element."
                }
              },
              "required": [
                "programEvaluationElementTitle"
              ]
            },
            "description": "Student ratings for program evaluation elements. Folded Common; element title is the local discriminator (full element FK validated at command layer)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "studentSourcedId",
          "evaluationDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentSchoolAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, schoolSourcedId, entryDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student enrolled in this school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the school enrolling the student.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "entryDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an individual enters and begins to receive instructional services in a school."
          },
          "exitWithdrawDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year of the first day after the date of an individual's last attendance at a school (if known), the day on which an individual graduated, or the date on which it becomes known officially that an individual left school."
          },
          "primarySchool": {
            "type": "boolean",
            "description": "Indicates if a given enrollment record should be considered the primary record for a student."
          },
          "entryGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grade level or primary instructional level at which a student enters and receives services in a school or an educational institution during a given academic session."
          },
          "entryGradeLevelReasonDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The primary reason as to why a staff member determined that a student should be promoted or not (or be demoted) at the end of a given school term."
          },
          "entryTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The process by which a student enters a school during a given academic session."
          },
          "exitWithdrawTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The circumstances under which the student exited from membership in an educational institution."
          },
          "repeatGradeIndicator": {
            "type": "boolean",
            "description": "An indicator of whether the student is enrolling to repeat a grade level, either by failure or an agreement to repeat."
          },
          "classOfSchoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "Projected high school graduation year."
          },
          "schoolChoiceTransfer": {
            "type": "boolean",
            "description": "An indication of whether students transferred in or out of the school did so during the school year under the provisions for public school choice in accordance with Title I, Part A, Section 1116."
          },
          "schoolChoice": {
            "type": "boolean",
            "description": "An indication that the student transferred to the school under a school choice provision."
          },
          "schoolChoiceBasisDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The legal basis for the school choice enrollment according to local, state or federal policy or regulation."
          },
          "residencyStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the location of a persons legal residence relative to (within or outside of) the boundaries of the public school attended and its administrative unit."
          },
          "graduationPlanTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of academic plan the student is following for graduation."
          },
          "graduationSchoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year the student is expected to graduate."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with the student's enrollment."
          },
          "educationOrganizationNetworkSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Optional reference to the education organization network (e.g. charter network) the school belongs to for this enrollment. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "employedWhileEnrolled": {
            "type": "boolean",
            "description": "An individual who is a paid employee or works in his or her own business, profession, or farm and at the same time is enrolled in secondary, postsecondary, or adult education."
          },
          "fullTimeEquivalency": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "The full-time equivalent measure of a student's course load as a decimal."
          },
          "termCompletionIndicator": {
            "type": "boolean",
            "description": "Indicates whether the student completed the term."
          },
          "enrollmentTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of enrollment reflected by the StudentSchoolAssociation."
          },
          "nextYearGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The anticipated grade level for the student for the next school year."
          },
          "nextYearSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The anticipated school of enrollment for the student for the next school year."
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar assigned to the student's school enrollment."
          },
          "alternativeGraduationPlans": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "graduationPlanTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of academic plan the student is following for this alternative graduation path."
                },
                "graduationSchoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "The school year the student is expected to graduate under this alternative plan."
                }
              },
              "required": [
                "graduationPlanTypeDescriptor",
                "graduationSchoolYear"
              ]
            },
            "description": "The secondary graduation plan or plans associated with the student enrolled in the school. A multi-valued collection child of StudentSchoolAssociation keyed by the parent's natural key plus the graduation plan type descriptor and graduation school year discriminators. Items unique by (graduationPlanTypeDescriptor, graduationSchoolYear)."
          },
          "educationPlans": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationPlanDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of education plan the student is following (e.g. IEP, 504 Plan, General Education)."
                }
              },
              "required": [
                "educationPlanDescriptor"
              ]
            },
            "description": "The type of education plan(s) the student is following, if appropriate. A multi-valued collection child of StudentSchoolAssociation keyed by the parent's natural key plus the education plan descriptor discriminator. Items unique by (educationPlanDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "entryDate",
          "entryGradeLevelDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentSchoolAttendanceEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose attendance is being recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the attendance event occurred.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The session (e.g., school day or period) for which attendance is recorded."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence, Tardy)."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "The reason for the attendance event, if applicable."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which the student was being educated at the time of the event (e.g., Classroom, Homebound)."
          },
          "eventDuration": {
            "type": "number",
            "description": "The amount of time for the event as decimal hours."
          },
          "schoolAttendanceDuration": {
            "type": "number",
            "description": "The duration of the school attendance event in decimal hours."
          },
          "arrivalTime": {
            "type": "string",
            "description": "The time of day the student arrived."
          },
          "departureTime": {
            "type": "string",
            "description": "The time of day the student departed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this attendance record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "eventDate",
          "sessionName",
          "attendanceEventCategoryDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentSchoolFoodServiceProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student enrolled in the food service program. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the food service program."
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the food service program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of food service program (e.g., National School Lunch Program, School Breakfast Program)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student began participating in the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student ended participation in the program."
          },
          "directCertification": {
            "type": "boolean",
            "description": "Indicates whether the student was directly certified for free meals without a household application."
          },
          "schoolFoodServiceProgramServiceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The food service program service (e.g., Free Breakfast, Reduced Price Lunch, Full Price Breakfast)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this program association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentSection504ProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "section504Eligibility": {
            "type": "boolean",
            "description": "Indicates whether student has a disability that qualifies student for Section 504 consideration. FALSE is equivalent to 'Did Not Qualify'."
          },
          "accommodationPlan": {
            "type": "boolean",
            "description": "Indicates whether student has a Section 504 accommodation plan."
          },
          "section504DisabilityDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Defines one or more disabilities student has that qualifies them for a Section 504 plan."
          },
          "section504MeetingDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the meeting with student's parent/guardian to discuss 504 eligibility."
          },
          "section504EligibilityDecisionDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the Section 504 eligibility decision is made."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "section504Eligibility",
          "updatedAt"
        ]
      },
      "StudentSectionAssociation": {
        "type": "object",
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the student assigned to this section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "classSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the section (class) to which the student is assigned. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the school organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the student's entry or assignment to the section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the withdrawal or exit of the student from the section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "role": {
            "type": "string",
            "enum": [
              "student"
            ],
            "description": "RESTRICTED to the enrollment role \"student\" — only student enrollment rows are visible through this projection."
          },
          "homeroomIndicator": {
            "type": "boolean",
            "description": "Indicates the section is the student's homeroom. Homeroom period may be the convention for taking combined attendance in some schools."
          },
          "teacherStudentDataLinkExclusion": {
            "type": "boolean",
            "description": "Indicates that the student-teacher relationship should be excluded from calculations that rank teachers in student growth or performance measures."
          },
          "attemptStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the student's completion status for the section."
          },
          "repeatIdentifierDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication as to whether a student has previously taken a given course (e.g., Repeated, Not Repeated, Replacement)."
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster sourcedId of the education organization that owns the program. References `oneroster:org.sourcedId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Bilingual, Special Education, Career and Technical Education)."
                }
              },
              "required": [
                "educationOrganizationSourcedId",
                "programName",
                "programTypeDescriptor"
              ]
            },
            "description": "The program(s) associated with a student's section enrollment. Items unique by (educationOrganizationSourcedId, programName, programTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "Deterministic GUID derived from the projection's natural-key columns. Server-generated (GENERATED … STORED); routes detail + If-Match."
          },
          "dateLastModified": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "classSourcedId",
          "schoolSourcedId",
          "beginDate",
          "role",
          "recordState",
          "dateLastModified"
        ]
      },
      "StudentSectionAssociationExtension": {
        "type": "object",
        "properties": {
          "enrollmentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Shared natural id with the OneRoster enrollment this student section association extension belongs to 1:1. FK CASCADE so deleting the enrollment reaps the companion.",
            "x-references": "oneroster:enrollment.sourcedId",
            "x-onDelete": "cascade"
          },
          "homeroomIndicator": {
            "type": "boolean",
            "description": "Indicates the section is the student's homeroom. Homeroom period may be the convention for taking combined attendance in some schools."
          },
          "teacherStudentDataLinkExclusion": {
            "type": "boolean",
            "description": "Indicates that the student-teacher relationship should be excluded from calculations that rank teachers in student growth or performance measures."
          },
          "attemptStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the student's completion status for the section."
          },
          "repeatIdentifierDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication as to whether a student has previously taken a given course (e.g., Repeated, Not Repeated, Replacement)."
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster sourcedId of the education organization that owns the program. References `oneroster:org.sourcedId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Bilingual, Special Education, Career and Technical Education)."
                }
              },
              "required": [
                "educationOrganizationSourcedId",
                "programName",
                "programTypeDescriptor"
              ]
            },
            "description": "The program(s) associated with a student's section enrollment. Items unique by (educationOrganizationSourcedId, programName, programTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        },
        "required": [
          "enrollmentSourcedId"
        ]
      },
      "StudentSectionAttendanceEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose section attendance is being recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the section attendance event occurred.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The class (section) for which attendance is being recorded. Projects to the Alpha attendanceEvent's section reference.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event. Projects to the Alpha attendanceEvent's eventDate."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence, Tardy). This field projects to the Alpha attendanceEvent's category field."
          },
          "sectionIdentifier": {
            "type": "string",
            "maxLength": 255,
            "description": "The local identifier assigned to the section, providing a descriptive link."
          },
          "localCourseCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "The reason for the attendance event, if applicable."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which the student was being educated at the time of the event (e.g., Classroom, Homebound)."
          },
          "eventDuration": {
            "type": "number",
            "description": "The amount of time for the event as decimal hours."
          },
          "sectionAttendanceDuration": {
            "type": "number",
            "description": "The duration of the section attendance event in decimal hours."
          },
          "arrivalTime": {
            "type": "string",
            "description": "The time of day the student arrived."
          },
          "departureTime": {
            "type": "string",
            "description": "The time of day the student departed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this attendance record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "classSourcedId",
          "eventDate",
          "attendanceEventCategoryDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentSpecialEducationProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for `{id}` wire routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the special education program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the special education program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (Special Education)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "ideaEligibility": {
            "type": "boolean",
            "description": "Indicator of the eligibility of the student to receive special education services according to the Individuals with Disabilities Education Act (IDEA)."
          },
          "specialEducationSettingDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The major instructional setting (more than 50 percent of a student's special education program)."
          },
          "specialEducationHoursPerWeek": {
            "type": "number",
            "minimum": 0,
            "description": "The number of hours per week for special education instruction and target services."
          },
          "schoolHoursPerWeek": {
            "type": "number",
            "minimum": 0,
            "description": "The number of hours per week the student attends school."
          },
          "multiplyDisabled": {
            "type": "boolean",
            "description": "Indicates whether the student receiving special education and related services has been designated as multiply disabled by the admission, review, and dismissal committee as appropriate."
          },
          "medicallyFragile": {
            "type": "boolean",
            "description": "Indicates whether the student receiving special education and related services is medically fragile — a chronic illness."
          },
          "lastEvaluationDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the last special education evaluation."
          },
          "iepBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The effective date of the current Individualized Education Program (IEP)."
          },
          "iepEndDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the current Individualized Education Program (IEP)."
          },
          "iepReviewDate": {
            "type": "string",
            "format": "date",
            "description": "The date the IEP was last reviewed."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's special education program participation over time. A multi-valued collection child of studentSpecialEducationProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "specialEducationProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "specialEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the special education program (e.g., speech therapy, occupational therapy, physical therapy)."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this option for the current school year."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this option for the current school year."
                }
              },
              "required": [
                "specialEducationProgramServiceDescriptor"
              ]
            },
            "description": "Indicates the service(s) being provided to the student by the special education program. A multi-valued collection child of studentSpecialEducationProgramAssociation keyed by the parent's 5-column natural key plus the specialEducationProgramServiceDescriptor discriminator. Items unique by (specialEducationProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentSpecialEducationProgramEligibilityAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, educationOrganizationSourcedId, studentSourcedId, programEducationOrganizationId, programName, programTypeDescriptor, consentToEvaluationReceivedDate).",
            "readOnly": true
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization where the student was evaluated for special education services.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student who is evaluated by a local education agency or a school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the program being evaluated for (program natural-key leg).",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program being evaluated for."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the program being evaluated for."
          },
          "consentToEvaluationReceivedDate": {
            "type": "string",
            "format": "date",
            "description": "Date on which the LEA received written consent for the evaluation from the student's parent."
          },
          "originalECIServicesDate": {
            "type": "string",
            "format": "date",
            "description": "Date when an infant or toddler began participating in early childhood intervention services."
          },
          "ideaPartDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Indicates if the evaluation is done under Part B IDEA or Part C IDEA."
          },
          "consentToEvaluationDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the student's parent gave consent (Parent Consent Date)."
          },
          "evaluationCompleteIndicator": {
            "type": "boolean",
            "description": "Indicates the evaluation completed status."
          },
          "eligibilityEvaluationDate": {
            "type": "string",
            "format": "date",
            "description": "Date when the written individual evaluation report was completed."
          },
          "eligibilityEvaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Indicates if this is an initial evaluation or a reevaluation."
          },
          "evaluationDelayReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Justification as to why the evaluation report was completed beyond the state-established timeframe."
          },
          "evaluationLateReason": {
            "type": "string",
            "maxLength": 255,
            "description": "Additional information for delay in doing the evaluation."
          },
          "evaluationDelayDays": {
            "type": "integer",
            "description": "Number of student absences contributing to evaluation delay."
          },
          "eligibilityDeterminationDate": {
            "type": "string",
            "format": "date",
            "description": "Date the LEA held the ARD committee meeting regarding eligibility."
          },
          "ideaIndicator": {
            "type": "boolean",
            "description": "Indicates whether or not the student was determined eligible as a result of an evaluation."
          },
          "eligibilityDelayReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason why the eligibility determination was completed beyond the required timeframe."
          },
          "transitionNotificationDate": {
            "type": "string",
            "format": "date",
            "description": "Date the LEA Notification of Potentially Eligible for Special Education Services was sent."
          },
          "transitionConferenceDate": {
            "type": "string",
            "format": "date",
            "description": "Date when the transition conference was held."
          },
          "eligibilityConferenceDate": {
            "type": "string",
            "format": "date",
            "description": "Date when the eligibility conference is held between parent(s)/guardian(s) and the educational organization."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "educationOrganizationSourcedId",
          "studentSourcedId",
          "programEducationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "consentToEvaluationReceivedDate",
          "ideaPartDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentTitleIPartAProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, studentSourcedId, programEducationOrganizationSourcedId, programName, programTypeDescriptor, beginDate). Used for `{id}` wire routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the Title I Part A program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the Title I Part A program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (Title I Part A)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "titleIPartAParticipantDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the type of Title I program, if any, in which the student is participating and by which the student is served (e.g., Public Targeted Assistance Program, Public Schoolwide Program, Private School Students Participating)."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's Title I Part A program participation over time. A multi-valued collection child of studentTitleIPartAProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "titleIPartAParticipantDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "StudentTransportation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key. Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose transportation is recorded. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school the student is transported to/from. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "amTransportation": {
            "type": "string",
            "maxLength": 60,
            "description": "The transportation mode for the morning commute (e.g., Bus, Walk, Parent Transport)."
          },
          "pmTransportation": {
            "type": "string",
            "maxLength": 60,
            "description": "The transportation mode for the afternoon commute (e.g., Bus, Walk, Parent Transport)."
          },
          "transportationPublicExpenseEligibilityTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Eligibility type for transportation at public expense (e.g., Eligible, Not Eligible)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student transportation record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "Survey": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the survey."
          },
          "surveyTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the survey."
          },
          "sessionName": {
            "type": "string",
            "maxLength": 60,
            "description": "The session during which the survey was administered."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year during which the survey was administered."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school associated with this survey.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "surveyCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of the survey."
          },
          "numberAdministered": {
            "type": "integer",
            "description": "The number of people to whom the survey was administered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveyCourseAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, educationOrganizationId, courseCode). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization that owns the course (roster org).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Course code within the education organization. Paired with educationOrganizationId; validated at the command layer against oneroster:course (projections cannot back FKs)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "educationOrganizationId",
          "courseCode",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveyProgramAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, educationOrganizationId, programName, programTypeDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization that owns the program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Program type."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveyQuestion": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, questionCode). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "questionCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code identifying this question within the survey."
          },
          "questionFormDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The form or type of the question (e.g., multiple choice, free response, Likert scale)."
          },
          "questionText": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "The text of the survey question as presented to respondents."
          },
          "surveySectionTitle": {
            "type": "string",
            "maxLength": 255,
            "description": "The title of the survey section to which this question belongs."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey question record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "questionCode",
          "questionFormDescriptor",
          "questionText",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveyQuestionResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier, questionCode). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "questionCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The code identifying the question being answered."
          },
          "noResponse": {
            "type": "boolean",
            "description": "Indicates that the respondent did not provide a response to this question."
          },
          "comment": {
            "type": "string",
            "maxLength": 1024,
            "description": "A comment or additional text provided with the response."
          },
          "numericResponse": {
            "type": "integer",
            "description": "A numeric value provided as the response."
          },
          "textResponse": {
            "type": "string",
            "maxLength": 2048,
            "description": "A free-text response provided by the respondent."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey question response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "questionCode",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveyResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for this particular survey response."
          },
          "responseDate": {
            "type": "string",
            "format": "date",
            "description": "The date the survey response was submitted."
          },
          "electronicMailAddress": {
            "type": "string",
            "maxLength": 128,
            "description": "The electronic mail address of the respondent."
          },
          "studentSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who responded to this survey (OneRoster roster identity boundary). Optional because surveys can be anonymous.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member who responded to this survey (OneRoster roster identity boundary). Optional because surveys can be anonymous.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "responseDate",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveyResponseEducationOrganizationTargetAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier, educationOrganizationId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the education organization targeted by this survey response."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "educationOrganizationId",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveyResponsePersonTargetAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier, personId, sourceSystemDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey response.",
            "x-references": "surveyResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who is the target of the survey response.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "personId",
          "sourceSystemDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveyResponseStaffTargetAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier, staffSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey response.",
            "x-references": "surveyResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Staff member who is the target of the survey response. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "staffSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveySection": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveySectionTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the survey section."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey section record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveySectionTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveySectionAggregateResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, personId, sourceSystemDescriptor, educationOrganizationSourcedId, evaluationPeriodDescriptor, performanceEvaluationTitle, performanceEvaluationTypeDescriptor, schoolYear, termDescriptor, evaluationTitle, evaluationDate, evaluationObjectiveTitle, evaluationElementTitle, namespace, surveyIdentifier, surveySectionTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation element rating.",
            "x-references": "evaluationElementRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey namespace.",
            "x-references": "surveySection.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Survey section title."
          },
          "scoreValue": {
            "type": "number",
            "description": "Aggregate score value."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "namespace",
          "surveyIdentifier",
          "surveySectionTitle",
          "scoreValue",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveySectionAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, classSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster class sourcedId identifying the section associated with the survey.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "classSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveySectionResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier, surveySectionTitle). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title of the survey section being responded to."
          },
          "sectionRating": {
            "type": "number",
            "description": "A numeric rating for this section provided by the respondent."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey section response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "surveySectionTitle",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveySectionResponseEducationOrganizationTargetAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier, surveySectionTitle, educationOrganizationId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title of the survey section being responded to."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the education organization targeted by this survey section response."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "surveySectionTitle",
          "educationOrganizationId",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveySectionResponsePersonTargetAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier, surveySectionTitle, personId, sourceSystemDescriptor). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey section response.",
            "x-references": "surveySectionResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey section title."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who is the target of the survey section response.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "surveySectionTitle",
          "personId",
          "sourceSystemDescriptor",
          "recordState",
          "updatedAt"
        ]
      },
      "SurveySectionResponseStaffTargetAssociation": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Deterministic GUID derived from the natural key (tenant, namespace, surveyIdentifier, surveyResponseIdentifier, surveySectionTitle, staffSourcedId). Used for {id} routing and If-Match concurrency.",
            "readOnly": true
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey section response.",
            "x-references": "surveySectionResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey section title."
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Staff member who is the target of the survey section response. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Server-managed last-update timestamp (RFC 3339). Read-only — never accepted on create or update."
          }
        },
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "surveySectionTitle",
          "staffSourcedId",
          "recordState",
          "updatedAt"
        ]
      },
      "CreateAcademicWeekRequest": {
        "type": "object",
        "description": "Create-AcademicWeek request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "weekIdentifier",
          "beginDate",
          "endDate",
          "totalInstructionalDays",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school this academic week belongs to.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "weekIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "The school label for the week."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The start date for the academic week."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date for the academic week."
          },
          "totalInstructionalDays": {
            "type": "integer",
            "description": "The total instructional days during the academic week."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateAcademicWeekRequest": {
        "type": "object",
        "description": "Update-AcademicWeek request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school this academic week belongs to.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "weekIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "The school label for the week."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The start date for the academic week."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date for the academic week."
          },
          "totalInstructionalDays": {
            "type": "integer",
            "description": "The total instructional days during the academic week."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateAccountabilityRatingRequest": {
        "type": "object",
        "description": "Create-AccountabilityRating request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "ratingTitle",
          "schoolYear",
          "rating",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization the accountability rating relates to.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "ratingTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The title of the rating."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year for which the accountability rating is assessed."
          },
          "rating": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "An accountability rating level, designation, or assessment."
          },
          "ratingDate": {
            "type": "string",
            "format": "date",
            "description": "The date the rating was awarded."
          },
          "ratingOrganization": {
            "type": "string",
            "maxLength": 35,
            "description": "The organization that assessed the rating."
          },
          "ratingProgram": {
            "type": "string",
            "maxLength": 30,
            "description": "The program associated with the accountability rating (e.g., NCLB, AEIS)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateAccountabilityRatingRequest": {
        "type": "object",
        "description": "Update-AccountabilityRating request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization the accountability rating relates to.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "ratingTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The title of the rating."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year for which the accountability rating is assessed."
          },
          "rating": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "An accountability rating level, designation, or assessment."
          },
          "ratingDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the rating was awarded."
          },
          "ratingOrganization": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 35,
            "description": "The organization that assessed the rating."
          },
          "ratingProgram": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "The program associated with the accountability rating (e.g., NCLB, AEIS)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateApplicantProfileRequest": {
        "type": "object",
        "description": "Create-ApplicantProfile request body (readOnly/server-managed fields excluded).",
        "required": [
          "applicantProfileIdentifier",
          "name",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Identifier assigned to a person making formal application."
          },
          "name": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal first name."
              },
              "lastSurname": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal last/surname."
              },
              "middleName": {
                "type": "string",
                "maxLength": 75,
                "description": "Middle name."
              },
              "personalTitlePrefix": {
                "type": "string",
                "maxLength": 30,
                "description": "Title prefix (e.g., Mr., Dr.)."
              },
              "generationCodeSuffix": {
                "type": "string",
                "maxLength": 10,
                "description": "Generation suffix (e.g., Jr., III)."
              },
              "maidenName": {
                "type": "string",
                "maxLength": 75,
                "description": "Maiden name."
              },
              "preferredFirstName": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred first name."
              },
              "preferredLastSurname": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred last/surname."
              }
            },
            "required": [
              "firstName",
              "lastSurname"
            ],
            "description": "Full legal name of the person."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Sex."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "Gender identity."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Birth date."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Street number and name."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "Apartment/room/suite."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Building/site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "City."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "State abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "Postal code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "County name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Locale."
                },
                "periods": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "beginDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Period begin date."
                      },
                      "endDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Period end date."
                      }
                    },
                    "required": [
                      "beginDate"
                    ],
                    "description": "periodsItem value."
                  },
                  "description": "Effective date periods."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses associated with the person."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Email address."
                },
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Email type."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "electronicMailAddress",
                "electronicMailTypeDescriptor"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race designations."
          },
          "citizenship": {
            "type": "object",
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages."
          },
          "backgroundChecks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "backgroundCheckTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Background check type."
                },
                "backgroundCheckRequestedDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date requested."
                },
                "backgroundCheckStatusDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Background check status."
                },
                "backgroundCheckCompletedDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date completed."
                },
                "fingerprint": {
                  "type": "boolean",
                  "description": "Fingerprint indicator."
                }
              },
              "required": [
                "backgroundCheckTypeDescriptor",
                "backgroundCheckRequestedDate"
              ],
              "description": "backgroundChecksItem value."
            },
            "description": "Background checks."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "economicDisadvantageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Economic disadvantage."
          },
          "firstGenerationStudent": {
            "type": "boolean",
            "description": "First-generation student indicator."
          },
          "applicantCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Applicant/student characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ],
              "description": "applicantCharacteristicsItem value."
            },
            "description": "Applicant characteristics (folded)."
          },
          "highestCompletedLevelOfEducationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Highest completed level of education."
          },
          "yearsOfPriorProfessionalExperience": {
            "type": "number",
            "description": "Years of prior professional experience."
          },
          "yearsOfPriorTeachingExperience": {
            "type": "number",
            "description": "Years of prior teaching experience."
          },
          "highlyQualifiedTeacher": {
            "type": "boolean",
            "description": "Highly qualified teacher indicator."
          },
          "highlyQualifiedAcademicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Academic subject."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ],
              "description": "highlyQualifiedAcademicSubjectsItem value."
            },
            "description": "Highly qualified academic subjects."
          },
          "gradePointAverages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradePointAverageTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "GPA type."
                },
                "isCumulative": {
                  "type": "boolean",
                  "description": "Cumulative indicator."
                },
                "gradePointAverageValue": {
                  "type": "number",
                  "description": "GPA value."
                },
                "maxGradePointAverageValue": {
                  "type": "number",
                  "description": "Max GPA value."
                }
              },
              "required": [
                "gradePointAverageTypeDescriptor",
                "gradePointAverageValue"
              ],
              "description": "gradePointAveragesItem value."
            },
            "description": "Grade point averages (folded)."
          },
          "educatorPreparationProgramNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educatorPreparationProgramName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Educator preparation program name."
                }
              },
              "required": [
                "educatorPreparationProgramName"
              ],
              "description": "educatorPreparationProgramNamesItem value."
            },
            "description": "Educator preparation program names."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateApplicantProfileRequest": {
        "type": "object",
        "description": "Update-ApplicantProfile request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Identifier assigned to a person making formal application."
          },
          "name": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal first name."
              },
              "lastSurname": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal last/surname."
              },
              "middleName": {
                "type": "string",
                "maxLength": 75,
                "description": "Middle name."
              },
              "personalTitlePrefix": {
                "type": "string",
                "maxLength": 30,
                "description": "Title prefix (e.g., Mr., Dr.)."
              },
              "generationCodeSuffix": {
                "type": "string",
                "maxLength": 10,
                "description": "Generation suffix (e.g., Jr., III)."
              },
              "maidenName": {
                "type": "string",
                "maxLength": 75,
                "description": "Maiden name."
              },
              "preferredFirstName": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred first name."
              },
              "preferredLastSurname": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred last/surname."
              }
            },
            "required": [
              "firstName",
              "lastSurname"
            ],
            "description": "Full legal name of the person."
          },
          "sexDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Sex."
          },
          "genderIdentity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Gender identity."
          },
          "birthDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Birth date."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Street number and name."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "Apartment/room/suite."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Building/site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "City."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "State abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "Postal code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "County name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Locale."
                },
                "periods": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "beginDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Period begin date."
                      },
                      "endDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Period end date."
                      }
                    },
                    "required": [
                      "beginDate"
                    ],
                    "description": "periodsItem value."
                  },
                  "description": "Effective date periods."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses associated with the person."
          },
          "internationalAddresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "electronicMails": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Email address."
                },
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Email type."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "electronicMailAddress",
                "electronicMailTypeDescriptor"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "hispanicLatinoEthnicity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race designations."
          },
          "citizenship": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages."
          },
          "backgroundChecks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "backgroundCheckTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Background check type."
                },
                "backgroundCheckRequestedDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date requested."
                },
                "backgroundCheckStatusDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Background check status."
                },
                "backgroundCheckCompletedDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date completed."
                },
                "fingerprint": {
                  "type": "boolean",
                  "description": "Fingerprint indicator."
                }
              },
              "required": [
                "backgroundCheckTypeDescriptor",
                "backgroundCheckRequestedDate"
              ],
              "description": "backgroundChecksItem value."
            },
            "description": "Background checks."
          },
          "disabilities": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "economicDisadvantageDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Economic disadvantage."
          },
          "firstGenerationStudent": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "First-generation student indicator."
          },
          "applicantCharacteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Applicant/student characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ],
              "description": "applicantCharacteristicsItem value."
            },
            "description": "Applicant characteristics (folded)."
          },
          "highestCompletedLevelOfEducationDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Highest completed level of education."
          },
          "yearsOfPriorProfessionalExperience": {
            "type": [
              "number",
              "null"
            ],
            "description": "Years of prior professional experience."
          },
          "yearsOfPriorTeachingExperience": {
            "type": [
              "number",
              "null"
            ],
            "description": "Years of prior teaching experience."
          },
          "highlyQualifiedTeacher": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Highly qualified teacher indicator."
          },
          "highlyQualifiedAcademicSubjects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Academic subject."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ],
              "description": "highlyQualifiedAcademicSubjectsItem value."
            },
            "description": "Highly qualified academic subjects."
          },
          "gradePointAverages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradePointAverageTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "GPA type."
                },
                "isCumulative": {
                  "type": "boolean",
                  "description": "Cumulative indicator."
                },
                "gradePointAverageValue": {
                  "type": "number",
                  "description": "GPA value."
                },
                "maxGradePointAverageValue": {
                  "type": "number",
                  "description": "Max GPA value."
                }
              },
              "required": [
                "gradePointAverageTypeDescriptor",
                "gradePointAverageValue"
              ],
              "description": "gradePointAveragesItem value."
            },
            "description": "Grade point averages (folded)."
          },
          "educatorPreparationProgramNames": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educatorPreparationProgramName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Educator preparation program name."
                }
              },
              "required": [
                "educatorPreparationProgramName"
              ],
              "description": "educatorPreparationProgramNamesItem value."
            },
            "description": "Educator preparation program names."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateApplicationRequest": {
        "type": "object",
        "description": "Create-Application request body (readOnly/server-managed fields excluded).",
        "required": [
          "applicationIdentifier",
          "educationOrganizationSourcedId",
          "applicantProfileIdentifier",
          "applicationDate",
          "applicationStatusDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "applicationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Identifier assigned to the application."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization receiving the application. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The applicant profile submitting the application.",
            "x-references": "applicantProfile.applicantProfileIdentifier",
            "x-onDelete": "restrict"
          },
          "applicationDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the application."
          },
          "applicationStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Application status."
          },
          "currentEmployee": {
            "type": "boolean",
            "description": "Whether the applicant is a current employee."
          },
          "academicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Academic subject."
          },
          "acceptedDate": {
            "type": "string",
            "format": "date",
            "description": "Date accepted."
          },
          "applicationSourceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Application source."
          },
          "firstContactDate": {
            "type": "string",
            "format": "date",
            "description": "First contact date."
          },
          "highNeedsAcademicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "High-needs academic subject."
          },
          "hireStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Hire status."
          },
          "hiringSourceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Hiring source."
          },
          "withdrawDate": {
            "type": "string",
            "format": "date",
            "description": "Withdraw date."
          },
          "withdrawReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Withdraw reason."
          },
          "terms": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term."
                }
              },
              "required": [
                "termDescriptor"
              ],
              "description": "termsItem value."
            },
            "description": "Terms associated with the application."
          },
          "scoreResults": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "result": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 35,
                  "description": "Result value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Result datatype."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Assessment reporting method."
                }
              },
              "required": [
                "result",
                "resultDatatypeTypeDescriptor",
                "assessmentReportingMethodDescriptor"
              ],
              "description": "scoreResultsItem value."
            },
            "description": "Score results (folded)."
          },
          "openStaffPositionEducationOrganizationId": {
            "type": "string",
            "maxLength": 60,
            "description": "Education organization of the optional open staff position.",
            "x-references": "openStaffPosition.educationOrganizationId",
            "x-references-legs": [
              "requisitionNumber"
            ],
            "x-onDelete": "restrict"
          },
          "requisitionNumber": {
            "type": "string",
            "maxLength": 20,
            "description": "Requisition number of the optional open staff position."
          },
          "recruitmentEventAttendances": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "recruitmentEventAttendeeIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 32,
                  "description": "Attendee identifier."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Recruitment event education organization."
                },
                "eventTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Recruitment event title."
                },
                "eventDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Recruitment event date."
                }
              },
              "required": [
                "recruitmentEventAttendeeIdentifier",
                "educationOrganizationSourcedId",
                "eventTitle",
                "eventDate"
              ],
              "description": "recruitmentEventAttendancesItem value."
            },
            "description": "Linked recruitment event attendances (folded reference collection)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateApplicationRequest": {
        "type": "object",
        "description": "Update-Application request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "applicationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Identifier assigned to the application."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization receiving the application. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The applicant profile submitting the application.",
            "x-references": "applicantProfile.applicantProfileIdentifier",
            "x-onDelete": "restrict"
          },
          "applicationDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the application."
          },
          "applicationStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Application status."
          },
          "currentEmployee": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the applicant is a current employee."
          },
          "academicSubjectDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Academic subject."
          },
          "acceptedDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date accepted."
          },
          "applicationSourceDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Application source."
          },
          "firstContactDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "First contact date."
          },
          "highNeedsAcademicSubjectDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "High-needs academic subject."
          },
          "hireStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Hire status."
          },
          "hiringSourceDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Hiring source."
          },
          "withdrawDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Withdraw date."
          },
          "withdrawReasonDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Withdraw reason."
          },
          "terms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term."
                }
              },
              "required": [
                "termDescriptor"
              ],
              "description": "termsItem value."
            },
            "description": "Terms associated with the application."
          },
          "scoreResults": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "result": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 35,
                  "description": "Result value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Result datatype."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Assessment reporting method."
                }
              },
              "required": [
                "result",
                "resultDatatypeTypeDescriptor",
                "assessmentReportingMethodDescriptor"
              ],
              "description": "scoreResultsItem value."
            },
            "description": "Score results (folded)."
          },
          "openStaffPositionEducationOrganizationId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Education organization of the optional open staff position.",
            "x-references": "openStaffPosition.educationOrganizationId",
            "x-references-legs": [
              "requisitionNumber"
            ],
            "x-onDelete": "restrict"
          },
          "requisitionNumber": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 20,
            "description": "Requisition number of the optional open staff position."
          },
          "recruitmentEventAttendances": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "recruitmentEventAttendeeIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 32,
                  "description": "Attendee identifier."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Recruitment event education organization."
                },
                "eventTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Recruitment event title."
                },
                "eventDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Recruitment event date."
                }
              },
              "required": [
                "recruitmentEventAttendeeIdentifier",
                "educationOrganizationSourcedId",
                "eventTitle",
                "eventDate"
              ],
              "description": "recruitmentEventAttendancesItem value."
            },
            "description": "Linked recruitment event attendances (folded reference collection)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateApplicationEventRequest": {
        "type": "object",
        "description": "Create-ApplicationEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "applicationIdentifier",
          "educationOrganizationSourcedId",
          "applicantProfileIdentifier",
          "eventDate",
          "sequenceNumber",
          "applicationEventTypeDescriptor",
          "schoolYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "applicationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Parent application identifier.",
            "x-references": "application.applicationIdentifier",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "applicantProfileIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent application."
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Applicant profile of the parent application."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the application event."
          },
          "eventEndDate": {
            "type": "string",
            "format": "date",
            "description": "End date of the application event."
          },
          "sequenceNumber": {
            "type": "integer",
            "description": "Sequence number of the event."
          },
          "applicationEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Application event type."
          },
          "applicationEvaluationScore": {
            "type": "number",
            "description": "Evaluation score."
          },
          "applicationEventResultDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Application event result."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year associated with the event."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Term."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateApplicationEventRequest": {
        "type": "object",
        "description": "Update-ApplicationEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "applicationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Parent application identifier.",
            "x-references": "application.applicationIdentifier",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "applicantProfileIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent application."
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Applicant profile of the parent application."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the application event."
          },
          "eventEndDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "End date of the application event."
          },
          "sequenceNumber": {
            "type": "integer",
            "description": "Sequence number of the event."
          },
          "applicationEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Application event type."
          },
          "applicationEvaluationScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "Evaluation score."
          },
          "applicationEventResultDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Application event result."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year associated with the event."
          },
          "termDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Term."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateAssessmentRequest": {
        "type": "object",
        "description": "Create-Assessment request body (readOnly/server-managed fields excluded).",
        "required": [
          "assessmentIdentifier",
          "namespace",
          "assessmentTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an assessment by a school, school system, a state, or other agency or entity."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the assessment, typically a URI like uri://ed-fi.org/Assessment/..."
          },
          "assessmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The title or name of the assessment."
          },
          "assessmentCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of an assessment based on format and content."
          },
          "assessmentForm": {
            "type": "string",
            "maxLength": 60,
            "description": "Identifies the form of the assessment, for example a regular versus makeup form."
          },
          "assessmentVersion": {
            "type": "integer",
            "description": "The version identifier for the assessment."
          },
          "revisionDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year that the conceptual design for the assessment was most recently revised substantially."
          },
          "maxRawScore": {
            "type": "number",
            "description": "The maximum raw score achievable across all assessment items that are correct and scored at the maximum."
          },
          "nomenclature": {
            "type": "string",
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used for assessment."
          },
          "adaptiveAssessment": {
            "type": "boolean",
            "description": "Indicates that the assessment is adaptive."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject associated with the assessment (e.g., Mathematics, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject tested by an assessment. Collection child of Assessment, allowing multiple subjects per assessment. Items unique by (academicSubjectDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The system that assigned the identification code (e.g., State, Federal, Test Contractor)."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to the assessment by the identification system."
                },
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The organization code or name assigning the assessment identification code."
                }
              },
              "required": [
                "assessmentIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an assessment by a governing body (e.g., state assessment ID, federal ID). Collection child of Assessment. Items unique by (assessmentIdentificationSystemDescriptor)."
          },
          "performanceLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level (e.g., Below Basic, Basic, Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method used for this performance level definition."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score required to achieve this performance level."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score within this performance level."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level definition for an assessment, defining cut scores and descriptors for categorizing student performance (e.g., Below Basic, Basic, Proficient, Advanced). Collection child of Assessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentPeriodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The period of time in which the assessment is administered (e.g., BOY, MOY, EOY)."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the assessment is to be administered."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the assessment is to be administered."
                }
              },
              "required": [
                "assessmentPeriodDescriptor"
              ]
            },
            "description": "A period associated with an assessment, describing when the assessment is administered. Collection child of Assessment. Items unique by (assessmentPeriodDescriptor)."
          },
          "scores": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The method that the administrator of the assessment uses to report the performance and achievement of all students (e.g., Scale score, Raw score, Percentile)."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score possible on this assessment score."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score possible on this assessment score."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result (e.g., Integer, Decimal, Level)."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A score definition for an assessment, describing how results are reported (e.g., scale score, raw score, percentile). Collection child of Assessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateAssessmentRequest": {
        "type": "object",
        "description": "Update-Assessment request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an assessment by a school, school system, a state, or other agency or entity."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the assessment, typically a URI like uri://ed-fi.org/Assessment/..."
          },
          "assessmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The title or name of the assessment."
          },
          "assessmentCategoryDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The category of an assessment based on format and content."
          },
          "assessmentForm": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Identifies the form of the assessment, for example a regular versus makeup form."
          },
          "assessmentVersion": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The version identifier for the assessment."
          },
          "revisionDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year that the conceptual design for the assessment was most recently revised substantially."
          },
          "maxRawScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "The maximum raw score achievable across all assessment items that are correct and scored at the maximum."
          },
          "nomenclature": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used for assessment."
          },
          "adaptiveAssessment": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates that the assessment is adaptive."
          },
          "academicSubjects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject associated with the assessment (e.g., Mathematics, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject tested by an assessment. Collection child of Assessment, allowing multiple subjects per assessment. Items unique by (academicSubjectDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "assessmentIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The system that assigned the identification code (e.g., State, Federal, Test Contractor)."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to the assessment by the identification system."
                },
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The organization code or name assigning the assessment identification code."
                }
              },
              "required": [
                "assessmentIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an assessment by a governing body (e.g., state assessment ID, federal ID). Collection child of Assessment. Items unique by (assessmentIdentificationSystemDescriptor)."
          },
          "performanceLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level (e.g., Below Basic, Basic, Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method used for this performance level definition."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score required to achieve this performance level."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score within this performance level."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level definition for an assessment, defining cut scores and descriptors for categorizing student performance (e.g., Below Basic, Basic, Proficient, Advanced). Collection child of Assessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "periods": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "assessmentPeriodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The period of time in which the assessment is administered (e.g., BOY, MOY, EOY)."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the assessment is to be administered."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the assessment is to be administered."
                }
              },
              "required": [
                "assessmentPeriodDescriptor"
              ]
            },
            "description": "A period associated with an assessment, describing when the assessment is administered. Collection child of Assessment. Items unique by (assessmentPeriodDescriptor)."
          },
          "scores": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The method that the administrator of the assessment uses to report the performance and achievement of all students (e.g., Scale score, Raw score, Percentile)."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score possible on this assessment score."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score possible on this assessment score."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result (e.g., Integer, Decimal, Level)."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A score definition for an assessment, describing how results are reported (e.g., scale score, raw score, percentile). Collection child of Assessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateAssessmentAdministrationRequest": {
        "type": "object",
        "description": "Create-AssessmentAdministration request body (readOnly/server-managed fields excluded).",
        "required": [
          "assigningEducationOrganizationSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationIdentifier",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization which contracts for or administers the assessment. Roster FK to oneroster:org.sourcedId (module EdOrg convention; schools/LEAs are OneRoster projections).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment being administered.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the assessment in the context of its administration."
          },
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Anticipated dates for the assessment administration window."
          },
          "assessmentBatteryParts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentBatteryPartName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Battery part name offered in this administration."
                }
              },
              "required": [
                "assessmentBatteryPartName"
              ],
              "description": "assessmentBatteryPartsItem value."
            },
            "description": "Parts of the assessment battery offered in this administration."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateAssessmentAdministrationRequest": {
        "type": "object",
        "description": "Update-AssessmentAdministration request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization which contracts for or administers the assessment. Roster FK to oneroster:org.sourcedId (module EdOrg convention; schools/LEAs are OneRoster projections).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment being administered.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the assessment in the context of its administration."
          },
          "periods": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Anticipated dates for the assessment administration window."
          },
          "assessmentBatteryParts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "assessmentBatteryPartName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Battery part name offered in this administration."
                }
              },
              "required": [
                "assessmentBatteryPartName"
              ],
              "description": "assessmentBatteryPartsItem value."
            },
            "description": "Parts of the assessment battery offered in this administration."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateAssessmentAdministrationParticipationRequest": {
        "type": "object",
        "description": "Create-AssessmentAdministrationParticipation request body (readOnly/server-managed fields excluded).",
        "required": [
          "assigningEducationOrganizationSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationIdentifier",
          "participatingEducationOrganizationSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assigning education organization of the parent administration.",
            "x-references": "assessmentAdministration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the parent administration."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent administration."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "participatingEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The participating education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "administrationPointOfContacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Education organization of the contact."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Contact email."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Contact first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Contact last surname."
                },
                "loginId": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Contact login id."
                }
              },
              "required": [
                "educationOrganizationId",
                "electronicMailAddress",
                "firstName",
                "lastSurname"
              ],
              "description": "administrationPointOfContactsItem value."
            },
            "description": "Pre-identified contacts for education organizations administering the assessment."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateAssessmentAdministrationParticipationRequest": {
        "type": "object",
        "description": "Update-AssessmentAdministrationParticipation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assigning education organization of the parent administration.",
            "x-references": "assessmentAdministration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the parent administration."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent administration."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "participatingEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The participating education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "administrationPointOfContacts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Education organization of the contact."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Contact email."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Contact first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Contact last surname."
                },
                "loginId": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Contact login id."
                }
              },
              "required": [
                "educationOrganizationId",
                "electronicMailAddress",
                "firstName",
                "lastSurname"
              ],
              "description": "administrationPointOfContactsItem value."
            },
            "description": "Pre-identified contacts for education organizations administering the assessment."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateAssessmentBatteryPartRequest": {
        "type": "object",
        "description": "Create-AssessmentBatteryPart request body (readOnly/server-managed fields excluded).",
        "required": [
          "assessmentIdentifier",
          "namespace",
          "assessmentBatteryPartName",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this battery part belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "assessmentBatteryPartName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The name of the part of an assessment battery."
          },
          "objectiveAssessments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Objective assessment identification code."
                }
              },
              "required": [
                "identificationCode"
              ],
              "description": "objectiveAssessmentsItem value."
            },
            "description": "Objective assessments administered by this battery part. Items unique by (identificationCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateAssessmentBatteryPartRequest": {
        "type": "object",
        "description": "Update-AssessmentBatteryPart request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this battery part belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "assessmentBatteryPartName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The name of the part of an assessment battery."
          },
          "objectiveAssessments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Objective assessment identification code."
                }
              },
              "required": [
                "identificationCode"
              ],
              "description": "objectiveAssessmentsItem value."
            },
            "description": "Objective assessments administered by this battery part. Items unique by (identificationCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateAssessmentItemRequest": {
        "type": "object",
        "description": "Create-AssessmentItem request body (readOnly/server-managed fields excluded).",
        "required": [
          "assessmentIdentifier",
          "namespace",
          "identificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this item belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to this assessment item."
          },
          "assessmentItemCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Category or type of the assessment item (e.g., multiple choice, essay)."
          },
          "maxRawScore": {
            "type": "number",
            "description": "The maximum raw score for this item."
          },
          "expectedTimeAssessed": {
            "type": "string",
            "maxLength": 30,
            "description": "The expected time to assess this item."
          },
          "nomenclature": {
            "type": "string",
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used."
          },
          "assessmentItemUri": {
            "type": "string",
            "maxLength": 255,
            "description": "URI to the assessment item content."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this assessment item record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateAssessmentItemRequest": {
        "type": "object",
        "description": "Update-AssessmentItem request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this item belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to this assessment item."
          },
          "assessmentItemCategoryDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Category or type of the assessment item (e.g., multiple choice, essay)."
          },
          "maxRawScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "The maximum raw score for this item."
          },
          "expectedTimeAssessed": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "The expected time to assess this item."
          },
          "nomenclature": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used."
          },
          "assessmentItemUri": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "URI to the assessment item content."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this assessment item record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateAssessmentScoreRangeLearningStandardRequest": {
        "type": "object",
        "description": "Create-AssessmentScoreRangeLearningStandard request body (readOnly/server-managed fields excluded).",
        "required": [
          "assessmentIdentifier",
          "namespace",
          "scoreRangeId",
          "minimumScore",
          "maximumScore",
          "learningStandards",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment with which the score range is associated.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment."
          },
          "scoreRangeId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to the score range."
          },
          "minimumScore": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "The minimum score in the score range."
          },
          "maximumScore": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "The maximum score in the score range."
          },
          "assessmentReportingMethodDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The assessment reporting method for the score range."
          },
          "objectiveAssessmentIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Optional objective assessment identification code within the assessment (assessmentIdentifier + namespace + this code). Association integrity enforced at command layer."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Learning standard id associated with the score range."
                }
              },
              "required": [
                "learningStandardId"
              ],
              "description": "learningStandardsItem value."
            },
            "description": "Learning standards associated with the score range. Nested resource references validated at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateAssessmentScoreRangeLearningStandardRequest": {
        "type": "object",
        "description": "Update-AssessmentScoreRangeLearningStandard request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment with which the score range is associated.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment."
          },
          "scoreRangeId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to the score range."
          },
          "minimumScore": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "The minimum score in the score range."
          },
          "maximumScore": {
            "type": "string",
            "minLength": 1,
            "maxLength": 35,
            "description": "The maximum score in the score range."
          },
          "assessmentReportingMethodDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The assessment reporting method for the score range."
          },
          "objectiveAssessmentIdentificationCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Optional objective assessment identification code within the assessment (assessmentIdentifier + namespace + this code). Association integrity enforced at command layer."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Learning standard id associated with the score range."
                }
              },
              "required": [
                "learningStandardId"
              ],
              "description": "learningStandardsItem value."
            },
            "description": "Learning standards associated with the score range. Nested resource references validated at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateBalanceSheetDimensionRequest": {
        "type": "object",
        "description": "Create-BalanceSheetDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "code",
          "fiscalYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateBalanceSheetDimensionRequest": {
        "type": "object",
        "description": "Update-BalanceSheetDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateBellScheduleRequest": {
        "type": "object",
        "description": "Create-BellSchedule request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "bellScheduleName"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this bell schedule belongs to. Establishes the cross-module FK into OneRoster.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "bellScheduleName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the bell schedule (e.g. 'Regular', 'Early Release', 'Assembly')."
          },
          "totalInstructionalTime": {
            "type": "string",
            "maxLength": 30,
            "description": "The total instructional time in the bell schedule (HH:MM format or minutes)."
          },
          "startTime": {
            "type": "string",
            "maxLength": 15,
            "description": "The start time for the bell schedule (HH:MM or HH:MM:SS format)."
          },
          "endTime": {
            "type": "string",
            "maxLength": 15,
            "description": "The end time for the bell schedule (HH:MM or HH:MM:SS format)."
          },
          "alternativeName": {
            "type": "string",
            "maxLength": 60,
            "description": "An alternative or abbreviated name for the bell schedule."
          },
          "classPeriods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "classPeriodName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The name of the class period assigned to this bell schedule."
                }
              },
              "required": [
                "classPeriodName"
              ]
            },
            "description": "An association between a bell schedule and a class period, establishing which class periods are part of a given bell schedule. Each row represents one class period assignment. Items unique by (classPeriodName)."
          },
          "dates": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date",
                  "description": "The specific calendar date on which this bell schedule is in effect."
                }
              },
              "required": [
                "date"
              ]
            },
            "description": "A specific calendar date on which a bell schedule is in effect. Each row represents one date assignment to a bell schedule. Items unique by (date)."
          },
          "meetingTimes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "startTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The start time of this meeting time block (HH:MM or HH:MM:SS format)."
                },
                "endTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The end time of this meeting time block (HH:MM or HH:MM:SS format)."
                },
                "officialAttendancePeriod": {
                  "type": "boolean",
                  "description": "Indicates whether this meeting time is the official attendance period for reporting purposes."
                }
              },
              "required": [
                "startTime",
                "endTime"
              ]
            },
            "description": "A meeting time window within a bell schedule, defining a start time and end time for a class period slot. Each row represents one time block in the bell schedule. Items unique by (startTime, endTime)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this bell schedule record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateBellScheduleRequest": {
        "type": "object",
        "description": "Update-BellSchedule request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "totalInstructionalTime": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "The total instructional time in the bell schedule (HH:MM format or minutes)."
          },
          "startTime": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 15,
            "description": "The start time for the bell schedule (HH:MM or HH:MM:SS format)."
          },
          "endTime": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 15,
            "description": "The end time for the bell schedule (HH:MM or HH:MM:SS format)."
          },
          "alternativeName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "An alternative or abbreviated name for the bell schedule."
          },
          "classPeriods": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "classPeriodName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The name of the class period assigned to this bell schedule."
                }
              },
              "required": [
                "classPeriodName"
              ]
            },
            "description": "An association between a bell schedule and a class period, establishing which class periods are part of a given bell schedule. Each row represents one class period assignment. Items unique by (classPeriodName)."
          },
          "dates": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date",
                  "description": "The specific calendar date on which this bell schedule is in effect."
                }
              },
              "required": [
                "date"
              ]
            },
            "description": "A specific calendar date on which a bell schedule is in effect. Each row represents one date assignment to a bell schedule. Items unique by (date)."
          },
          "meetingTimes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "startTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The start time of this meeting time block (HH:MM or HH:MM:SS format)."
                },
                "endTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The end time of this meeting time block (HH:MM or HH:MM:SS format)."
                },
                "officialAttendancePeriod": {
                  "type": "boolean",
                  "description": "Indicates whether this meeting time is the official attendance period for reporting purposes."
                }
              },
              "required": [
                "startTime",
                "endTime"
              ]
            },
            "description": "A meeting time window within a bell schedule, defining a start time and end time for a class period slot. Each row represents one time block in the bell schedule. Items unique by (startTime, endTime)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this bell schedule record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCalendarRequest": {
        "type": "object",
        "description": "Create-Calendar request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "calendarCode",
          "schoolYear",
          "calendarTypeDescriptor"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school owning this calendar. Establishes the cross-module FK into OneRoster.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to a calendar. Unique within the school and school year."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year for which the calendar is defined (e.g. 2025 for the 2024-2025 school year)."
          },
          "calendarTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of calendar (e.g. Student Specific, IEP, School). References the CalendarTypeDescriptor governed value."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level served by this calendar (e.g. First grade, Ninth grade). References the GradeLevelDescriptor governed value."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level served by a calendar. A calendar may serve multiple grade levels; each row represents one grade level association. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this calendar record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCalendarRequest": {
        "type": "object",
        "description": "Update-Calendar request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "calendarTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of calendar (e.g. Student Specific, IEP, School). References the CalendarTypeDescriptor governed value."
          },
          "gradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level served by this calendar (e.g. First grade, Ninth grade). References the GradeLevelDescriptor governed value."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level served by a calendar. A calendar may serve multiple grade levels; each row represents one grade level association. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this calendar record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCalendarDateRequest": {
        "type": "object",
        "description": "Create-CalendarDate request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "calendarCode",
          "schoolYear",
          "date"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The school's OneRoster sourcedId. FK to calendar — together with calendarCode and schoolYear forms the composite reference to the parent calendar.",
            "x-references": "calendar.schoolSourcedId",
            "x-references-legs": [
              "calendarCode",
              "schoolYear"
            ],
            "x-onDelete": "soft-cascade"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The calendar code identifying the parent calendar within the school and school year."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year of the parent calendar."
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "The specific calendar date (ISO 8601 date). The key discriminator within the parent calendar."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this calendar date record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCalendarDateRequest": {
        "type": "object",
        "description": "Update-CalendarDate request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this calendar date record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCalendarDateCalendarEventRequest": {
        "type": "object",
        "description": "Create-CalendarDateCalendarEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "calendarCode",
          "schoolYear",
          "date",
          "calendarEventDescriptor"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The school's OneRoster sourcedId. FK to calendarDate — together with calendarCode, schoolYear, and date forms the composite reference to the parent calendar date.",
            "x-references": "calendarDate.schoolSourcedId",
            "x-references-legs": [
              "calendarCode",
              "schoolYear",
              "date"
            ],
            "x-onDelete": "soft-cascade"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The calendar code identifying the parent calendar."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year of the parent calendar."
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "The specific calendar date this event belongs to."
          },
          "calendarEventDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of calendar event (e.g. Instructional day, Holiday, Teacher only day, Make-up day). References the CalendarEventDescriptor governed value."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this calendar event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCalendarDateCalendarEventRequest": {
        "type": "object",
        "description": "Update-CalendarDateCalendarEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The school's OneRoster sourcedId. FK to calendarDate — together with calendarCode, schoolYear, and date forms the composite reference to the parent calendar date.",
            "x-references": "calendarDate.schoolSourcedId",
            "x-references-legs": [
              "calendarCode",
              "schoolYear",
              "date"
            ],
            "x-onDelete": "soft-cascade"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The calendar code identifying the parent calendar."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year of the parent calendar."
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "The specific calendar date this event belongs to."
          },
          "calendarEventDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of calendar event (e.g. Instructional day, Holiday, Teacher only day, Make-up day). References the CalendarEventDescriptor governed value."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this calendar event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCandidateRequest": {
        "type": "object",
        "description": "Create-Candidate request body (readOnly/server-managed fields excluded).",
        "required": [
          "candidateIdentifier",
          "firstName",
          "lastSurname",
          "sexDescriptor",
          "birthDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a candidate."
          },
          "personalTitlePrefix": {
            "type": "string",
            "maxLength": 30,
            "description": "Personal title prefix."
          },
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "Legal first name."
          },
          "middleName": {
            "type": "string",
            "maxLength": 75,
            "description": "Middle name."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "Legal last/surname."
          },
          "generationCodeSuffix": {
            "type": "string",
            "maxLength": 10,
            "description": "Generation suffix."
          },
          "maidenName": {
            "type": "string",
            "maxLength": 75,
            "description": "Maiden name."
          },
          "preferredFirstName": {
            "type": "string",
            "maxLength": 75,
            "description": "Preferred first name."
          },
          "preferredLastSurname": {
            "type": "string",
            "maxLength": 75,
            "description": "Preferred last surname."
          },
          "sexDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Sex of the candidate."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "Gender identity."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Date of birth."
          },
          "birthCity": {
            "type": "string",
            "maxLength": 30,
            "description": "City of birth."
          },
          "birthStateAbbreviationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "State of birth."
          },
          "birthInternationalProvince": {
            "type": "string",
            "maxLength": 150,
            "description": "International province of birth."
          },
          "birthCountryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Country of birth."
          },
          "dateEnteredUS": {
            "type": "string",
            "format": "date",
            "description": "Date entered the US."
          },
          "multipleBirthStatus": {
            "type": "boolean",
            "description": "Multiple birth status."
          },
          "birthSexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Birth sex."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "City."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "Postal code."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Street number and name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "State abbreviation."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "Apartment/room/suite."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "Addresses."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "countryDescriptor",
                "addressLine1"
              ]
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ]
            },
            "description": "Telephone numbers."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Email address."
                },
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Email type."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailAddress",
                "electronicMailTypeDescriptor"
              ]
            },
            "description": "Electronic mail addresses."
          },
          "otherNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Other name type."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Title prefix."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "First name."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Middle name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Last surname."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "Generation suffix."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Other names."
          },
          "profileThumbnail": {
            "type": "string",
            "maxLength": 255,
            "description": "Profile thumbnail URI."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "Races."
          },
          "citizenship": {
            "type": "object",
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ]
                },
                "description": "Visas."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship."
          },
          "economicDisadvantageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Economic disadvantage."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "candidateCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Candidate characteristic."
                }
              },
              "required": [
                "candidateCharacteristicDescriptor"
              ]
            },
            "description": "Candidate characteristics."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Limited English proficiency."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ]
                  },
                  "description": "Language uses."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "Languages."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Diagnosis."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "Disabilities."
          },
          "displacementStatus": {
            "type": "string",
            "maxLength": 30,
            "description": "Displacement status."
          },
          "indicators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator group."
                },
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator name."
                },
                "indicatorBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Indicator begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Indicator end date."
                },
                "indicator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "indicatorName",
                "indicatorBeginDate",
                "indicator"
              ]
            },
            "description": "Indicators."
          },
          "loginId": {
            "type": "string",
            "maxLength": 120,
            "description": "Login ID."
          },
          "tuitionCost": {
            "type": "number",
            "description": "Tuition cost."
          },
          "backgroundCheck": {
            "type": "object",
            "properties": {
              "backgroundCheckTypeDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Background check type."
              },
              "backgroundCheckRequestedDate": {
                "type": "string",
                "format": "date",
                "description": "Requested date."
              },
              "backgroundCheckStatusDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "Status."
              },
              "backgroundCheckCompletedDate": {
                "type": "string",
                "format": "date",
                "description": "Completed date."
              },
              "fingerprint": {
                "type": "boolean",
                "description": "Fingerprint indicator."
              }
            },
            "required": [
              "backgroundCheckTypeDescriptor",
              "backgroundCheckRequestedDate"
            ],
            "description": "Background check."
          },
          "englishLanguageExamDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "English language exam."
          },
          "previousCareerDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Previous career."
          },
          "firstGenerationStudent": {
            "type": "boolean",
            "description": "First-generation student indicator."
          },
          "ePPProgramDegrees": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Academic subject."
                },
                "ePPDegreeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "EPP degree type."
                },
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "academicSubjectDescriptor",
                "ePPDegreeTypeDescriptor",
                "gradeLevelDescriptor"
              ]
            },
            "description": "EPP program degrees."
          },
          "personId": {
            "type": "string",
            "maxLength": 32,
            "description": "Optional correlated person id.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Source system for the optional person correlation."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCandidateRequest": {
        "type": "object",
        "description": "Update-Candidate request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a candidate."
          },
          "personalTitlePrefix": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "Personal title prefix."
          },
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "Legal first name."
          },
          "middleName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "Middle name."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "Legal last/surname."
          },
          "generationCodeSuffix": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 10,
            "description": "Generation suffix."
          },
          "maidenName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "Maiden name."
          },
          "preferredFirstName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "Preferred first name."
          },
          "preferredLastSurname": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "Preferred last surname."
          },
          "sexDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Sex of the candidate."
          },
          "genderIdentity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Gender identity."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Date of birth."
          },
          "birthCity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "City of birth."
          },
          "birthStateAbbreviationDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "State of birth."
          },
          "birthInternationalProvince": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 150,
            "description": "International province of birth."
          },
          "birthCountryDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Country of birth."
          },
          "dateEnteredUS": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date entered the US."
          },
          "multipleBirthStatus": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Multiple birth status."
          },
          "birthSexDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Birth sex."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "City."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "Postal code."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Street number and name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "State abbreviation."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "Apartment/room/suite."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "Addresses."
          },
          "internationalAddresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Address type."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "countryDescriptor",
                "addressLine1"
              ]
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ]
            },
            "description": "Telephone numbers."
          },
          "electronicMails": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "Email address."
                },
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Email type."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailAddress",
                "electronicMailTypeDescriptor"
              ]
            },
            "description": "Electronic mail addresses."
          },
          "otherNames": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Other name type."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Title prefix."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "First name."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Middle name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Last surname."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "Generation suffix."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Other names."
          },
          "profileThumbnail": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Profile thumbnail URI."
          },
          "hispanicLatinoEthnicity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "Races."
          },
          "citizenship": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ]
                },
                "description": "Visas."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship."
          },
          "economicDisadvantageDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Economic disadvantage."
          },
          "characteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "candidateCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Candidate characteristic."
                }
              },
              "required": [
                "candidateCharacteristicDescriptor"
              ]
            },
            "description": "Candidate characteristics."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Limited English proficiency."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ]
                  },
                  "description": "Language uses."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "Languages."
          },
          "disabilities": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Diagnosis."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "Disabilities."
          },
          "displacementStatus": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "Displacement status."
          },
          "indicators": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator group."
                },
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator name."
                },
                "indicatorBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Indicator begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Indicator end date."
                },
                "indicator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "indicatorName",
                "indicatorBeginDate",
                "indicator"
              ]
            },
            "description": "Indicators."
          },
          "loginId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120,
            "description": "Login ID."
          },
          "tuitionCost": {
            "type": [
              "number",
              "null"
            ],
            "description": "Tuition cost."
          },
          "backgroundCheck": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "backgroundCheckTypeDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Background check type."
              },
              "backgroundCheckRequestedDate": {
                "type": "string",
                "format": "date",
                "description": "Requested date."
              },
              "backgroundCheckStatusDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "Status."
              },
              "backgroundCheckCompletedDate": {
                "type": "string",
                "format": "date",
                "description": "Completed date."
              },
              "fingerprint": {
                "type": "boolean",
                "description": "Fingerprint indicator."
              }
            },
            "required": [
              "backgroundCheckTypeDescriptor",
              "backgroundCheckRequestedDate"
            ],
            "description": "Background check."
          },
          "englishLanguageExamDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "English language exam."
          },
          "previousCareerDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Previous career."
          },
          "firstGenerationStudent": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "First-generation student indicator."
          },
          "ePPProgramDegrees": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Academic subject."
                },
                "ePPDegreeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "EPP degree type."
                },
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "academicSubjectDescriptor",
                "ePPDegreeTypeDescriptor",
                "gradeLevelDescriptor"
              ]
            },
            "description": "EPP program degrees."
          },
          "personId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Optional correlated person id.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Source system for the optional person correlation."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCandidateEducatorPreparationProgramAssociationRequest": {
        "type": "object",
        "description": "Create-CandidateEducatorPreparationProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "candidateIdentifier",
          "educationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the EPP.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "EPP program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "EPP program type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Association begin date."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Association end date."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Reason exited."
          },
          "ePPProgramPathwayDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "EPP program pathway."
          },
          "candidateIndicators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator group."
                },
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator name."
                },
                "indicatorBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                },
                "indicator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "indicatorName",
                "indicatorBeginDate",
                "indicator"
              ]
            },
            "description": "Candidate indicators for this association."
          },
          "degreeSpecializations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "majorSpecialization": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Major specialization."
                },
                "minorSpecialization": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Minor specialization."
                },
                "specializationBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Specialization begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Specialization end date."
                }
              },
              "required": [
                "majorSpecialization",
                "specializationBeginDate"
              ]
            },
            "description": "Degree specializations."
          },
          "cohortYears": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "schoolYear": {
                  "type": "integer",
                  "description": "School year."
                },
                "cohortYearTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Cohort year type."
                },
                "termDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Term."
                }
              },
              "required": [
                "schoolYear",
                "cohortYearTypeDescriptor"
              ]
            },
            "description": "Cohort years."
          },
          "applicationIdentifier": {
            "type": "string",
            "maxLength": 20,
            "description": "Optional application identifier (Application is out of tier; command-layer)."
          },
          "applicantProfileIdentifier": {
            "type": "string",
            "maxLength": 32,
            "description": "Optional applicant profile identifier."
          },
          "applicationEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional application education organization sourcedId."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCandidateEducatorPreparationProgramAssociationRequest": {
        "type": "object",
        "description": "Update-CandidateEducatorPreparationProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the EPP.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "EPP program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "EPP program type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Association begin date."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Association end date."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Reason exited."
          },
          "ePPProgramPathwayDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "EPP program pathway."
          },
          "candidateIndicators": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator group."
                },
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator name."
                },
                "indicatorBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date."
                },
                "indicator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Designated by."
                }
              },
              "required": [
                "indicatorName",
                "indicatorBeginDate",
                "indicator"
              ]
            },
            "description": "Candidate indicators for this association."
          },
          "degreeSpecializations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "majorSpecialization": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Major specialization."
                },
                "minorSpecialization": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Minor specialization."
                },
                "specializationBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Specialization begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Specialization end date."
                }
              },
              "required": [
                "majorSpecialization",
                "specializationBeginDate"
              ]
            },
            "description": "Degree specializations."
          },
          "cohortYears": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "schoolYear": {
                  "type": "integer",
                  "description": "School year."
                },
                "cohortYearTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Cohort year type."
                },
                "termDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Term."
                }
              },
              "required": [
                "schoolYear",
                "cohortYearTypeDescriptor"
              ]
            },
            "description": "Cohort years."
          },
          "applicationIdentifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 20,
            "description": "Optional application identifier (Application is out of tier; command-layer)."
          },
          "applicantProfileIdentifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Optional applicant profile identifier."
          },
          "applicationEducationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional application education organization sourcedId."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCandidateIdentificationCodeRequest": {
        "type": "object",
        "description": "Create-CandidateIdentificationCode request body (readOnly/server-managed fields excluded).",
        "required": [
          "candidateIdentifier",
          "candidateIdentificationSystemDescriptor",
          "educationOrganizationSourcedId",
          "identificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "candidateIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Identification system."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The identification code value."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Assigning organization identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCandidateIdentificationCodeRequest": {
        "type": "object",
        "description": "Update-CandidateIdentificationCode request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "candidateIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Identification system."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The identification code value."
          },
          "assigningOrganizationIdentificationCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Assigning organization identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCandidateRelationshipToStaffAssociationRequest": {
        "type": "object",
        "description": "Create-CandidateRelationshipToStaffAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "candidateIdentifier",
          "staffSourcedId",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffToCandidateRelationshipDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Relationship type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Relationship begin date."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Relationship end date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCandidateRelationshipToStaffAssociationRequest": {
        "type": "object",
        "description": "Update-CandidateRelationshipToStaffAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "candidateIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The candidate.",
            "x-references": "candidate.candidateIdentifier",
            "x-onDelete": "cascade"
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffToCandidateRelationshipDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Relationship type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Relationship begin date."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Relationship end date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCertificationRequest": {
        "type": "object",
        "description": "Create-Certification request body (readOnly/server-managed fields excluded).",
        "required": [
          "certificationIdentifier",
          "namespace",
          "certificationTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "certificationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the certification."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the certification, typically associated with the issuing authority."
          },
          "certificationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "The title of the certification."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that authorizes the certification, often a state education agency.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "certificationLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The level or category of the certification."
          },
          "certificationFieldDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The field of certification."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level certified for teaching."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade level(s) certified for teaching. Folded descriptor collection."
          },
          "routes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "certificationRouteDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The process, program, or pathway used to obtain the certification."
                }
              },
              "required": [
                "certificationRouteDescriptor"
              ]
            },
            "description": "Certification routes. Folded descriptor collection."
          },
          "certificationStandardDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The standard, law, or policy defining the certification."
          },
          "minimumDegreeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The minimum level of degree, if any, required for the certification."
          },
          "educatorRoleDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The role authorized by the certification."
          },
          "populationServedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of students that the certification is offered and tailored to."
          },
          "instructionalSettingDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting authorized by the certification."
          },
          "certificationExams": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "certificationExamIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "Certification exam identifier. Cross-fragment FK to certificationExam; validated at command layer."
                },
                "certificationExamNamespace": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Certification exam namespace."
                }
              },
              "required": [
                "certificationExamIdentifier",
                "certificationExamNamespace"
              ]
            },
            "description": "Certification exams required for the certification. Folded collection; FK to certificationExam validated at command layer (schema-level FK does not survive jsonb fold)."
          },
          "effectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification is offered."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification offering is expected to end."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCertificationRequest": {
        "type": "object",
        "description": "Update-Certification request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "certificationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the certification."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the certification, typically associated with the issuing authority."
          },
          "certificationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "The title of the certification."
          },
          "educationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that authorizes the certification, often a state education agency.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "certificationLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The level or category of the certification."
          },
          "certificationFieldDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The field of certification."
          },
          "gradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level certified for teaching."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade level(s) certified for teaching. Folded descriptor collection."
          },
          "routes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "certificationRouteDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The process, program, or pathway used to obtain the certification."
                }
              },
              "required": [
                "certificationRouteDescriptor"
              ]
            },
            "description": "Certification routes. Folded descriptor collection."
          },
          "certificationStandardDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The standard, law, or policy defining the certification."
          },
          "minimumDegreeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The minimum level of degree, if any, required for the certification."
          },
          "educatorRoleDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The role authorized by the certification."
          },
          "populationServedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of students that the certification is offered and tailored to."
          },
          "instructionalSettingDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The setting authorized by the certification."
          },
          "certificationExams": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "certificationExamIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "Certification exam identifier. Cross-fragment FK to certificationExam; validated at command layer."
                },
                "certificationExamNamespace": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Certification exam namespace."
                }
              },
              "required": [
                "certificationExamIdentifier",
                "certificationExamNamespace"
              ]
            },
            "description": "Certification exams required for the certification. Folded collection; FK to certificationExam validated at command layer (schema-level FK does not survive jsonb fold)."
          },
          "effectiveDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the certification is offered."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the certification offering is expected to end."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCertificationExamRequest": {
        "type": "object",
        "description": "Create-CertificationExam request body (readOnly/server-managed fields excluded).",
        "required": [
          "certificationExamIdentifier",
          "namespace",
          "certificationExamTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "certificationExamIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the certification exam."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the certification exam."
          },
          "certificationExamTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The title of the certification exam."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the certification exam.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "certificationExamTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type or category of the certification exam."
          },
          "effectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification exam is offered."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification exam offering is expected to end."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCertificationExamRequest": {
        "type": "object",
        "description": "Update-CertificationExam request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "certificationExamIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the certification exam."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the certification exam."
          },
          "certificationExamTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The title of the certification exam."
          },
          "educationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the certification exam.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "certificationExamTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type or category of the certification exam."
          },
          "effectiveDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the certification exam is offered."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the certification exam offering is expected to end."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCertificationExamResultRequest": {
        "type": "object",
        "description": "Create-CertificationExamResult request body (readOnly/server-managed fields excluded).",
        "required": [
          "certificationExamIdentifier",
          "namespace",
          "personId",
          "sourceSystemDescriptor",
          "certificationExamDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "certificationExamIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Certification exam identifier (certificationExam natural-key leg).",
            "x-references": "certificationExam.certificationExamIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace leg of the certification exam natural key."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person who took the certification exam (person natural-key leg).",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system leg of the person natural key."
          },
          "certificationExamDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification exam is taken."
          },
          "attemptNumber": {
            "type": "integer",
            "description": "The number of the person's attempt for the certification exam."
          },
          "certificationExamScore": {
            "type": "number",
            "description": "The score result for the certification exam attempt."
          },
          "certificationExamPassIndicator": {
            "type": "boolean",
            "description": "Indicator that the person passed the certification exam."
          },
          "certificationExamStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The status of the certification exam attempt."
          },
          "studentAssessmentIdentifier": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional studentAssessmentIdentifier for a detailed assessment result. Full studentAssessment FK validated at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCertificationExamResultRequest": {
        "type": "object",
        "description": "Update-CertificationExamResult request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "certificationExamIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Certification exam identifier (certificationExam natural-key leg).",
            "x-references": "certificationExam.certificationExamIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace leg of the certification exam natural key."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person who took the certification exam (person natural-key leg).",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system leg of the person natural key."
          },
          "certificationExamDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the certification exam is taken."
          },
          "attemptNumber": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The number of the person's attempt for the certification exam."
          },
          "certificationExamScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "The score result for the certification exam attempt."
          },
          "certificationExamPassIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator that the person passed the certification exam."
          },
          "certificationExamStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The status of the certification exam attempt."
          },
          "studentAssessmentIdentifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120,
            "description": "Optional studentAssessmentIdentifier for a detailed assessment result. Full studentAssessment FK validated at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateChartOfAccountRequest": {
        "type": "object",
        "description": "Create-ChartOfAccount request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the account is valid."
          },
          "accountName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the account."
          },
          "accountCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of the account (e.g., Fund, Function, Object)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateChartOfAccountRequest": {
        "type": "object",
        "description": "Update-ChartOfAccount request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the account is valid."
          },
          "accountName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "A descriptive name for the account."
          },
          "accountCategoryDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The category of the account (e.g., Fund, Function, Object)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateClassPeriodRequest": {
        "type": "object",
        "description": "Create-ClassPeriod request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "classPeriodName"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this class period belongs to. Establishes the cross-module FK into OneRoster.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classPeriodName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the class period (e.g. '01 - Traditional', 'Homeroom', 'Lunch')."
          },
          "officialAttendancePeriod": {
            "type": "boolean",
            "description": "Indicates whether this class period is the official attendance-taking period for reporting purposes."
          },
          "meetingTimes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "startTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The start time of this class period meeting time (HH:MM or HH:MM:SS format)."
                },
                "endTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The end time of this class period meeting time (HH:MM or HH:MM:SS format)."
                }
              },
              "required": [
                "startTime",
                "endTime"
              ]
            },
            "description": "A meeting time definition for a class period, specifying the start and end time of the period. Each row represents one time window for a class period within a school. Items unique by (startTime, endTime)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this class period record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateClassPeriodRequest": {
        "type": "object",
        "description": "Update-ClassPeriod request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "officialAttendancePeriod": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether this class period is the official attendance-taking period for reporting purposes."
          },
          "meetingTimes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "startTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The start time of this class period meeting time (HH:MM or HH:MM:SS format)."
                },
                "endTime": {
                  "type": "string",
                  "maxLength": 15,
                  "description": "The end time of this class period meeting time (HH:MM or HH:MM:SS format)."
                }
              },
              "required": [
                "startTime",
                "endTime"
              ]
            },
            "description": "A meeting time definition for a class period, specifying the start and end time of the period. Each row represents one time window for a class period within a school. Items unique by (startTime, endTime)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this class period record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCohortRequest": {
        "type": "object",
        "description": "Create-Cohort request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "cohortIdentifier",
          "cohortTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "cohortDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "The description of the cohort and its purpose."
          },
          "cohortTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of cohort (e.g., Academic Intervention, Attendance Intervention, Study Hall)."
          },
          "cohortScopeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The scope of cohort (e.g., District, School, Classroom)."
          },
          "academicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The academic subject associated with the cohort."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this cohort record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCohortRequest": {
        "type": "object",
        "description": "Update-Cohort request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "cohortDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "The description of the cohort and its purpose."
          },
          "cohortTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of cohort (e.g., Academic Intervention, Attendance Intervention, Study Hall)."
          },
          "cohortScopeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The scope of cohort (e.g., District, School, Classroom)."
          },
          "academicSubjectDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The academic subject associated with the cohort."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this cohort record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCommunityOrganizationRequest": {
        "type": "object",
        "description": "Create-CommunityOrganization request body (readOnly/server-managed fields excluded).",
        "required": [
          "communityOrganizationId",
          "nameOfInstitution",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "communityOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier for the community organization."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full legally accepted name of the community organization."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 75,
            "description": "A short name for the community organization."
          },
          "webSite": {
            "type": "string",
            "maxLength": 255,
            "description": "The URL of the community organization's website."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The operational status of the community organization (e.g., Active, Inactive)."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a community organization. An organization may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this organization. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a community organization. An organization may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a community organization by an external system. An organization may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a community organization, classified by type (e.g. Main, Fax). An organization may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this community organization record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCommunityOrganizationRequest": {
        "type": "object",
        "description": "Update-CommunityOrganization request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "communityOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier for the community organization."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full legally accepted name of the community organization."
          },
          "shortNameOfInstitution": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "A short name for the community organization."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The URL of the community organization's website."
          },
          "operationalStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The operational status of the community organization (e.g., Active, Inactive)."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a community organization. An organization may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this organization. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a community organization. An organization may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a community organization by an external system. An organization may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a community organization, classified by type (e.g. Main, Fax). An organization may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this community organization record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCommunityProviderRequest": {
        "type": "object",
        "description": "Create-CommunityProvider request body (readOnly/server-managed fields excluded).",
        "required": [
          "communityProviderId",
          "nameOfInstitution",
          "providerCategoryDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "communityProviderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier for the community provider."
          },
          "communityOrganizationId": {
            "type": "string",
            "maxLength": 60,
            "description": "The community organization this provider belongs to, if applicable."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full legally accepted name of the community provider."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 75,
            "description": "A short name for the community provider."
          },
          "providerCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the provider (e.g., Center-based, Family Child Care)."
          },
          "providerStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The operating status of the provider (e.g., Active, Inactive, Closed)."
          },
          "providerProfitStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The profit status of the provider (e.g., For Profit, Non Profit)."
          },
          "schoolIndicator": {
            "type": "boolean",
            "description": "Indicates whether the provider is also a school."
          },
          "licenseExemptIndicator": {
            "type": "boolean",
            "description": "Indicates whether the provider is exempt from licensing requirements."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a community provider. A provider may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this provider. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a community provider. A provider may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a community provider by an external system. A provider may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a community provider, classified by type (e.g. Main, Fax). A provider may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this community provider record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCommunityProviderRequest": {
        "type": "object",
        "description": "Update-CommunityProvider request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "communityProviderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier for the community provider."
          },
          "communityOrganizationId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The community organization this provider belongs to, if applicable."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full legally accepted name of the community provider."
          },
          "shortNameOfInstitution": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "A short name for the community provider."
          },
          "providerCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the provider (e.g., Center-based, Family Child Care)."
          },
          "providerStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The operating status of the provider (e.g., Active, Inactive, Closed)."
          },
          "providerProfitStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The profit status of the provider (e.g., For Profit, Non Profit)."
          },
          "schoolIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the provider is also a school."
          },
          "licenseExemptIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the provider is exempt from licensing requirements."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a community provider. A provider may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this provider. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a community provider. A provider may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a community provider by an external system. A provider may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a community provider, classified by type (e.g. Main, Fax). A provider may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this community provider record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCommunityProviderLicenseRequest": {
        "type": "object",
        "description": "Create-CommunityProviderLicense request body (readOnly/server-managed fields excluded).",
        "required": [
          "communityProviderId",
          "licenseIdentifier",
          "licensingOrganization",
          "licenseTypeDescriptor",
          "licenseEffectiveDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "communityProviderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the community provider holding this license."
          },
          "licenseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The unique identifier of the license."
          },
          "licensingOrganization": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The organization that issued the license."
          },
          "licenseTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of license (e.g., child care, family care)."
          },
          "licenseEffectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the license became effective."
          },
          "licenseExpirationDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the license expires."
          },
          "licenseStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The status of the license (e.g., Active, Suspended, Revoked)."
          },
          "authorizedFacilityCapacity": {
            "type": "integer",
            "description": "The maximum number of individuals authorized to be served by the facility."
          },
          "oldestAgeAuthorized": {
            "type": "integer",
            "description": "The oldest age of individuals the facility is authorized to serve."
          },
          "youngestAgeAuthorized": {
            "type": "integer",
            "description": "The youngest age of individuals the facility is authorized to serve."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this license record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCommunityProviderLicenseRequest": {
        "type": "object",
        "description": "Update-CommunityProviderLicense request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "communityProviderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the community provider holding this license."
          },
          "licenseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The unique identifier of the license."
          },
          "licensingOrganization": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The organization that issued the license."
          },
          "licenseTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of license (e.g., child care, family care)."
          },
          "licenseEffectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the license became effective."
          },
          "licenseExpirationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date on which the license expires."
          },
          "licenseStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The status of the license (e.g., Active, Suspended, Revoked)."
          },
          "authorizedFacilityCapacity": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The maximum number of individuals authorized to be served by the facility."
          },
          "oldestAgeAuthorized": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The oldest age of individuals the facility is authorized to serve."
          },
          "youngestAgeAuthorized": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The youngest age of individuals the facility is authorized to serve."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this license record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCompetencyObjectiveRequest": {
        "type": "object",
        "description": "Create-CompetencyObjective request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "objective",
          "objectiveGradeLevelDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId that owns this competency objective (roster-reference boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "objective": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The designated title of the competency objective."
          },
          "objectiveGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grade level for which the competency objective is targeted."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "The description of the student competency objective."
          },
          "successCriteria": {
            "type": "string",
            "maxLength": 150,
            "description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a competency objective."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateCompetencyObjectiveRequest": {
        "type": "object",
        "description": "Update-CompetencyObjective request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId that owns this competency objective (roster-reference boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "objective": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The designated title of the competency objective."
          },
          "objectiveGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grade level for which the competency objective is targeted."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "The description of the student competency objective."
          },
          "successCriteria": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 150,
            "description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a competency objective."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateConformanceEvidenceRequest": {
        "type": "object",
        "description": "Create-ConformanceEvidence request body (readOnly/server-managed fields excluded).",
        "required": [
          "evidenceType",
          "coverageData",
          "generatedAt"
        ],
        "additionalProperties": false,
        "properties": {
          "evidenceType": {
            "type": "string",
            "enum": [
              "udm_coverage",
              "descriptor_governance",
              "roster_boundary"
            ],
            "description": "The type of conformance evidence: `udm_coverage` proves resource coverage breadth, `descriptor_governance` proves the descriptor registry is complete, `roster_boundary` proves roster-reference compliance."
          },
          "coverageData": {
            "type": "object",
            "description": "Structured evidence payload containing coverage metrics, missing resources, or compliance violations as appropriate for the evidence type."
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when this evidence record was generated."
          }
        }
      },
      "CreateContactRequest": {
        "type": "object",
        "description": "Create-Contact request body (readOnly/server-managed fields excluded).",
        "required": [
          "contactUniqueId",
          "firstName",
          "lastSurname",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "A unique alphanumeric code assigned to a contact. This is the Ed-Fi contact identity (not a roster sourcedId)."
          },
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The contact's legal first name."
          },
          "middleName": {
            "type": "string",
            "maxLength": 75,
            "description": "The contact's middle name, if any."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The contact's legal last/surname."
          },
          "generationCodeSuffix": {
            "type": "string",
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III)."
          },
          "maidenName": {
            "type": "string",
            "maxLength": 75,
            "description": "The contact's maiden name, if applicable."
          },
          "personalTitlePrefix": {
            "type": "string",
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the contact."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The contact's sex."
          },
          "loginId": {
            "type": "string",
            "maxLength": 60,
            "description": "The login ID for the user; used for entry into a system or service."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which the address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state or jurisdiction in which the address is located."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of the address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which the address is located."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "A postal address associated with a contact, discriminated by address type. Multiple addresses per contact are supported (home, mailing, physical, etc.). Items unique by (addressTypeDescriptor, city, postalCode, streetNumberName, stateAbbreviationDescriptor)."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "contactCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic or trait attributed to the contact — descriptor reference."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or became inapplicable."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "contactCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to a contact. Collection child of Contact, keyed on (tenant, contactUniqueId, contactCharacteristicDescriptor). Items unique by (contactCharacteristicDescriptor)."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the contact."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the contact."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a contact, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The organization code or name assigning the identification code."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to the contact by the organization."
                }
              },
              "required": [
                "assigningOrganizationIdentificationCode",
                "identificationCode"
              ]
            },
            "description": "A code assigned to a contact by an organization for identification purposes. Collection child of Contact, keyed on (tenant, contactUniqueId, assigningOrganizationIdentificationCode, identificationCode). Items unique by (assigningOrganizationIdentificationCode, identificationCode)."
          },
          "identificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity — descriptor reference."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose — descriptor reference."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing organization — descriptor reference."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to identify a contact. Collection child of Contact, keyed on (tenant, contactUniqueId, identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a contact, discriminated by address type. Items unique by (addressTypeDescriptor)."
          },
          "languageUses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The language this use context applies to."
                },
                "languageUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A description of how the language is used (e.g., Home language, Dominant language, Correspondence language)."
                }
              },
              "required": [
                "languageDescriptor",
                "languageUseDescriptor"
              ]
            },
            "description": "A use context for a language spoken by a contact (e.g., home language, dominant language), discriminated by both language and language-use descriptor. Items unique by (languageDescriptor, languageUseDescriptor)."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language the contact speaks or understands."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language spoken or understood by the contact, discriminated by language descriptor. Items unique by (languageDescriptor)."
          },
          "otherNames": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a contact (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The contact's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The contact's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The contact's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the contact is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor)."
          },
          "personalIdentificationDocuments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity — descriptor reference."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose — descriptor reference."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing organization — descriptor reference."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document held by the contact. Collection child of Contact, keyed on (tenant, contactUniqueId, identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category (e.g. American Indian - Alaska Native, Asian, Black - African American, Native Hawaiian - Pacific Islander, White) — descriptor reference."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "The general racial category which most clearly reflects the individual's recognition of their community or with which the contact most identifies. Collection child of Contact, keyed on (tenant, contactUniqueId, raceDescriptor). Items unique by (raceDescriptor)."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of communication number (e.g., Home, Mobile, Work, Emergency)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number associated with a contact, discriminated by telephone number type. Items unique by (telephoneNumberTypeDescriptor, telephoneNumber)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this contact record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateContactRequest": {
        "type": "object",
        "description": "Update-Contact request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "A unique alphanumeric code assigned to a contact. This is the Ed-Fi contact identity (not a roster sourcedId)."
          },
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The contact's legal first name."
          },
          "middleName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "The contact's middle name, if any."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The contact's legal last/surname."
          },
          "generationCodeSuffix": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III)."
          },
          "maidenName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "The contact's maiden name, if applicable."
          },
          "personalTitlePrefix": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the contact."
          },
          "sexDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The contact's sex."
          },
          "loginId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The login ID for the user; used for entry into a system or service."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which the address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state or jurisdiction in which the address is located."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of the address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which the address is located."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "A postal address associated with a contact, discriminated by address type. Multiple addresses per contact are supported (home, mailing, physical, etc.). Items unique by (addressTypeDescriptor, city, postalCode, streetNumberName, stateAbbreviationDescriptor)."
          },
          "characteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "contactCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic or trait attributed to the contact — descriptor reference."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or became inapplicable."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "contactCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to a contact. Collection child of Contact, keyed on (tenant, contactUniqueId, contactCharacteristicDescriptor). Items unique by (contactCharacteristicDescriptor)."
          },
          "electronicMails": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the contact."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the contact."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a contact, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The organization code or name assigning the identification code."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to the contact by the organization."
                }
              },
              "required": [
                "assigningOrganizationIdentificationCode",
                "identificationCode"
              ]
            },
            "description": "A code assigned to a contact by an organization for identification purposes. Collection child of Contact, keyed on (tenant, contactUniqueId, assigningOrganizationIdentificationCode, identificationCode). Items unique by (assigningOrganizationIdentificationCode, identificationCode)."
          },
          "identificationDocuments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity — descriptor reference."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose — descriptor reference."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing organization — descriptor reference."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to identify a contact. Collection child of Contact, keyed on (tenant, contactUniqueId, identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "internationalAddresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a contact, discriminated by address type. Items unique by (addressTypeDescriptor)."
          },
          "languageUses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The language this use context applies to."
                },
                "languageUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A description of how the language is used (e.g., Home language, Dominant language, Correspondence language)."
                }
              },
              "required": [
                "languageDescriptor",
                "languageUseDescriptor"
              ]
            },
            "description": "A use context for a language spoken by a contact (e.g., home language, dominant language), discriminated by both language and language-use descriptor. Items unique by (languageDescriptor, languageUseDescriptor)."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language the contact speaks or understands."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language spoken or understood by the contact, discriminated by language descriptor. Items unique by (languageDescriptor)."
          },
          "otherNames": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a contact (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The contact's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The contact's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The contact's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the contact is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor)."
          },
          "personalIdentificationDocuments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity — descriptor reference."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose — descriptor reference."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing organization — descriptor reference."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document held by the contact. Collection child of Contact, keyed on (tenant, contactUniqueId, identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "races": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category (e.g. American Indian - Alaska Native, Asian, Black - African American, Native Hawaiian - Pacific Islander, White) — descriptor reference."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "The general racial category which most clearly reflects the individual's recognition of their community or with which the contact most identifies. Collection child of Contact, keyed on (tenant, contactUniqueId, raceDescriptor). Items unique by (raceDescriptor)."
          },
          "telephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of communication number (e.g., Home, Mobile, Work, Emergency)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number associated with a contact, discriminated by telephone number type. Items unique by (telephoneNumberTypeDescriptor, telephoneNumber)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this contact record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateContactIdentificationCodeRequest": {
        "type": "object",
        "description": "Create-ContactIdentificationCode request body (readOnly/server-managed fields excluded).",
        "required": [
          "contactUniqueId",
          "contactIdentificationSystemDescriptor",
          "educationOrganizationSourcedId",
          "identificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The contact this identification code belongs to.",
            "x-references": "contact.contactUniqueId",
            "x-onDelete": "cascade"
          },
          "contactIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Identification system."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context for this contact identification code. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identification code value."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Assigning organization code or name."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateContactIdentificationCodeRequest": {
        "type": "object",
        "description": "Update-ContactIdentificationCode request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The contact this identification code belongs to.",
            "x-references": "contact.contactUniqueId",
            "x-onDelete": "cascade"
          },
          "contactIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Identification system."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context for this contact identification code. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identification code value."
          },
          "assigningOrganizationIdentificationCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Assigning organization code or name."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCourseRequest": {
        "type": "object",
        "description": "Create-Course request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "courseCode",
          "courseTitle",
          "numberOfParts",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster organization sourcedId that owns this course (Ed-Fi educationOrganizationId). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The course code assigned by the organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "courseTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The descriptive name of the course (OneRoster title). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "numberOfParts": {
            "type": "integer",
            "minimum": 1,
            "description": "The number of parts identified for a course. Ed-Fi-owned extends field."
          },
          "courseDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "A description of the content standards and goals covered in the course."
          },
          "timeRequiredForCompletion": {
            "type": "integer",
            "minimum": 0,
            "description": "The actual or estimated number of clock minutes required for class completion."
          },
          "dateCourseAdopted": {
            "type": "string",
            "format": "date",
            "description": "The date the course was adopted by the education organization."
          },
          "highSchoolCourseRequirement": {
            "type": "boolean",
            "description": "An indication that this course may satisfy high school graduation requirements."
          },
          "maxCompletionsForCredit": {
            "type": "integer",
            "minimum": 1,
            "description": "Designates how many times the course may be taken with credit received by the student."
          },
          "minimumAvailableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits awarded."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor to Carnegie units."
              }
            },
            "description": "The minimum amount of credit available to a student who successfully completes the course."
          },
          "maximumAvailableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits awarded."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor to Carnegie units."
              }
            },
            "description": "The maximum amount of credit available to a student who successfully completes the course."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area descriptor."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "Academic subject areas associated with the course."
          },
          "competencyLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "competencyLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The competency level descriptor."
                }
              },
              "required": [
                "competencyLevelDescriptor"
              ]
            },
            "description": "Competency levels associated with the course."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The identification system descriptor."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code value."
                }
              },
              "required": [
                "courseIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "Coding schemes used to identify the course."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The learning standard identifier this course addresses."
                }
              },
              "required": [
                "learningStandardId"
              ]
            },
            "description": "Learning standards addressed by the course."
          },
          "levelCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The course level characteristic descriptor."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "Course level characteristics (Honors, AP, IB, etc.)."
          },
          "offeredGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level descriptor."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Grade levels at which the course is offered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this course record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this course is deleted."
          }
        }
      },
      "UpdateCourseRequest": {
        "type": "object",
        "description": "Update-Course request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster organization sourcedId that owns this course (Ed-Fi educationOrganizationId). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The course code assigned by the organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "courseTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The descriptive name of the course (OneRoster title). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "numberOfParts": {
            "type": "integer",
            "minimum": 1,
            "description": "The number of parts identified for a course. Ed-Fi-owned extends field."
          },
          "courseDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "A description of the content standards and goals covered in the course."
          },
          "timeRequiredForCompletion": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "The actual or estimated number of clock minutes required for class completion."
          },
          "dateCourseAdopted": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the course was adopted by the education organization."
          },
          "highSchoolCourseRequirement": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication that this course may satisfy high school graduation requirements."
          },
          "maxCompletionsForCredit": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "Designates how many times the course may be taken with credit received by the student."
          },
          "minimumAvailableCredits": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits awarded."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor to Carnegie units."
              }
            },
            "description": "The minimum amount of credit available to a student who successfully completes the course."
          },
          "maximumAvailableCredits": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits awarded."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor to Carnegie units."
              }
            },
            "description": "The maximum amount of credit available to a student who successfully completes the course."
          },
          "academicSubjects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area descriptor."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "Academic subject areas associated with the course."
          },
          "competencyLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "competencyLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The competency level descriptor."
                }
              },
              "required": [
                "competencyLevelDescriptor"
              ]
            },
            "description": "Competency levels associated with the course."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "courseIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The identification system descriptor."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code value."
                }
              },
              "required": [
                "courseIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "Coding schemes used to identify the course."
          },
          "learningStandards": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The learning standard identifier this course addresses."
                }
              },
              "required": [
                "learningStandardId"
              ]
            },
            "description": "Learning standards addressed by the course."
          },
          "levelCharacteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The course level characteristic descriptor."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "Course level characteristics (Honors, AP, IB, etc.)."
          },
          "offeredGradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level descriptor."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Grade levels at which the course is offered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this course record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this course is deleted."
          }
        }
      },
      "CreateCourseOfferingRequest": {
        "type": "object",
        "description": "Create-CourseOffering request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "localCourseCode",
          "schoolYear",
          "sessionName",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId identifying the school offering this course (roster-reference boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "localCourseTitle": {
            "type": "string",
            "maxLength": 120,
            "description": "The descriptive name given to a course of study offered in the school."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The identifier for the school year in which the course is offered."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar session in which the course is offered."
          },
          "instructionalTimePlanned": {
            "type": "integer",
            "minimum": 0,
            "description": "The planned total number of clock minutes of instruction for this course offering."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the referenced course (roster org). Course identity is (educationOrganizationId, courseCode) on the Ed-Fi wire; the course row lives on oneroster:course.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The course code identifying the referenced parent course within the education organization. Paired with educationOrganizationId; validated at the command layer against the oneroster:course master (projections cannot back FKs)."
          },
          "courseLevelCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of course level characteristic (e.g., Honors, AP, IB, Dual Credit)."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a course offering level (e.g., Honors, AP, IB), discriminated by the course level characteristic descriptor. Collection child of CourseOffering. Items unique by (courseLevelCharacteristicDescriptor)."
          },
          "curriculumUseds": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "curriculumUsedDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of curriculum used in the course offering."
                }
              },
              "required": [
                "curriculumUsedDescriptor"
              ]
            },
            "description": "A curriculum used in a course offering, discriminated by the curriculum used descriptor. Collection child of CourseOffering. Items unique by (curriculumUsedDescriptor)."
          },
          "offeredGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level at which the course offering is offered (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level at which a course offering is offered, discriminated by the grade level descriptor. Collection child of CourseOffering. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateCourseOfferingRequest": {
        "type": "object",
        "description": "Update-CourseOffering request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId identifying the school offering this course (roster-reference boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "localCourseTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120,
            "description": "The descriptive name given to a course of study offered in the school."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The identifier for the school year in which the course is offered."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar session in which the course is offered."
          },
          "instructionalTimePlanned": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "The planned total number of clock minutes of instruction for this course offering."
          },
          "educationOrganizationId": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the referenced course (roster org). Course identity is (educationOrganizationId, courseCode) on the Ed-Fi wire; the course row lives on oneroster:course.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 120,
            "description": "The course code identifying the referenced parent course within the education organization. Paired with educationOrganizationId; validated at the command layer against the oneroster:course master (projections cannot back FKs)."
          },
          "courseLevelCharacteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of course level characteristic (e.g., Honors, AP, IB, Dual Credit)."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a course offering level (e.g., Honors, AP, IB), discriminated by the course level characteristic descriptor. Collection child of CourseOffering. Items unique by (courseLevelCharacteristicDescriptor)."
          },
          "curriculumUseds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "curriculumUsedDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of curriculum used in the course offering."
                }
              },
              "required": [
                "curriculumUsedDescriptor"
              ]
            },
            "description": "A curriculum used in a course offering, discriminated by the curriculum used descriptor. Collection child of CourseOffering. Items unique by (curriculumUsedDescriptor)."
          },
          "offeredGradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level at which the course offering is offered (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level at which a course offering is offered, discriminated by the grade level descriptor. Collection child of CourseOffering. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateCourseTranscriptRequest": {
        "type": "object",
        "description": "Create-CourseTranscript request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "courseCode",
          "schoolYear",
          "termDescriptor",
          "courseAttemptResultDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student (roster-reference boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the referenced course (roster org). Course identity is (educationOrganizationId, courseCode) on the Ed-Fi wire; the course row lives on oneroster:course.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The course code identifying the referenced course within the education organization. Paired with educationOrganizationId; validated at the command layer against the oneroster:course master (projections cannot back FKs)."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year during which the course was taken."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term in which the course was taken (e.g., Fall Semester, Spring Semester)."
          },
          "courseAttemptResultDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The result from the student's attempt to take the course (e.g., Pass, Fail, Incomplete)."
          },
          "finalLetterGradeEarned": {
            "type": "string",
            "maxLength": 20,
            "description": "The final indicator of student performance in a class as submitted by the instructor."
          },
          "finalNumericGradeEarned": {
            "type": "number",
            "description": "The final indicator of student performance in a class as submitted by the instructor, expressed as a numeric value."
          },
          "courseTitle": {
            "type": "string",
            "maxLength": 120,
            "description": "The descriptive name given to a course of study offered in a school or other institution or organization. In the case of a transcript this may be different from the official course title."
          },
          "alternativeCourseTitle": {
            "type": "string",
            "maxLength": 120,
            "description": "The descriptive name given to a course of study in which the student received credit that differs from the course title on the official transcript."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 120,
            "description": "The organization code or name assigning the course identification code."
          },
          "courseCatalogURL": {
            "type": "string",
            "maxLength": 255,
            "description": "The URL for the course catalog that defines the course identification code."
          },
          "earnedCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits or units of value awarded for the completion of a course."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value awarded for the completion of a course."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value awarded for the completion of a course."
          },
          "attemptedCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits or units of value attempted."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value attempted."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value attempted for a course."
          },
          "whenTakenGradeLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The student's grade level at time of course."
          },
          "methodCreditEarnedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The method the credits were earned (e.g., Classroom, Transferred)."
          },
          "courseRepeatCodeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Indicates that an academic course has been repeated by a student and how that repeat is to be computed in the student's academic record."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area (e.g., Mathematics, Science, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject area associated with a course transcript record, discriminated by the academic subject descriptor. Collection child of CourseTranscript. Items unique by (academicSubjectDescriptor)."
          },
          "alternativeCourseIdentificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A system that is used to identify the organization of subject matter and related learning experiences provided for the instruction of students (e.g., State course code, University course code)."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The alternative course identification code."
                }
              },
              "required": [
                "courseIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An alternative identification code for a course on a transcript, discriminated by the course identification system descriptor. Collection child of CourseTranscript. Items unique by (courseIdentificationSystemDescriptor)."
          },
          "coursePrograms": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseProgramName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "The formal name of the program of studies associated with the course on the student's transcript."
                },
                "courseProgramTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Special Education, Bilingual, Career and Technical Education)."
                }
              },
              "required": [
                "courseProgramName",
                "courseProgramTypeDescriptor"
              ]
            },
            "description": "A program associated with a course on a transcript, discriminated by program name and program type descriptor. Collection child of CourseTranscript. Items unique by (courseProgramName, courseProgramTypeDescriptor)."
          },
          "creditCategories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "creditCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A categorization for the course transcript credits awarded (e.g., Honors, AP, IB)."
                }
              },
              "required": [
                "creditCategoryDescriptor"
              ]
            },
            "description": "A credit category associated with a course transcript record, discriminated by the credit category descriptor. Collection child of CourseTranscript. Items unique by (creditCategoryDescriptor)."
          },
          "earnedAdditionalCredits": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "additionalCreditTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of additional credits earned (e.g., Advanced Placement, International Baccalaureate)."
                },
                "credits": {
                  "type": "number",
                  "description": "The value of additional credits or units of value earned."
                }
              },
              "required": [
                "additionalCreditTypeDescriptor",
                "credits"
              ]
            },
            "description": "Additional credits earned by a student for a course transcript, discriminated by the additional credit type descriptor. Collection child of CourseTranscript. Items unique by (additionalCreditTypeDescriptor)."
          },
          "partialCourseTranscriptAwards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "awardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the partial course transcript credits were awarded or earned."
                },
                "methodCreditEarnedDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The method the credits were earned (e.g., Classroom, Transferred)."
                },
                "letterGradeEarned": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 20,
                  "description": "The indicator of student performance for the partial course transcript award."
                },
                "earnedCredits": {
                  "type": "number",
                  "description": "The value of credits or units of value awarded for the partial course."
                }
              },
              "required": [
                "awardDate",
                "methodCreditEarnedDescriptor",
                "letterGradeEarned",
                "earnedCredits"
              ]
            },
            "description": "A partial course transcript award representing credits earned for a portion of a course, discriminated by award date, method credit earned descriptor, and letter grade earned. Collection child of CourseTranscript. Items unique by (awardDate, methodCreditEarnedDescriptor, letterGradeEarned)."
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The local identifier assigned to a section."
                },
                "schoolSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster organization sourcedId of the school offering the section."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The local code assigned by the school that identifies the course offering."
                },
                "sectionSchoolYear": {
                  "type": "integer",
                  "description": "The school year of the section."
                },
                "sectionTermDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The term descriptor for the section's session."
                }
              },
              "required": [
                "sectionIdentifier",
                "schoolSourcedId",
                "localCourseCode",
                "sectionSchoolYear",
                "sectionTermDescriptor"
              ]
            },
            "description": "An optional section reference associated with a course transcript, identifying the specific section in which the student was enrolled. Discriminated by section identifier, school, local course code, section school year, and term descriptor. Collection child of CourseTranscript. Items unique by (sectionIdentifier, schoolSourcedId, localCourseCode, sectionSchoolYear, sectionTermDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateCourseTranscriptRequest": {
        "type": "object",
        "description": "Update-CourseTranscript request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student (roster-reference boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the referenced course (roster org). Course identity is (educationOrganizationId, courseCode) on the Ed-Fi wire; the course row lives on oneroster:course.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "The course code identifying the referenced course within the education organization. Paired with educationOrganizationId; validated at the command layer against the oneroster:course master (projections cannot back FKs)."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year during which the course was taken."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term in which the course was taken (e.g., Fall Semester, Spring Semester)."
          },
          "courseAttemptResultDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The result from the student's attempt to take the course (e.g., Pass, Fail, Incomplete)."
          },
          "finalLetterGradeEarned": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 20,
            "description": "The final indicator of student performance in a class as submitted by the instructor."
          },
          "finalNumericGradeEarned": {
            "type": [
              "number",
              "null"
            ],
            "description": "The final indicator of student performance in a class as submitted by the instructor, expressed as a numeric value."
          },
          "courseTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120,
            "description": "The descriptive name given to a course of study offered in a school or other institution or organization. In the case of a transcript this may be different from the official course title."
          },
          "alternativeCourseTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120,
            "description": "The descriptive name given to a course of study in which the student received credit that differs from the course title on the official transcript."
          },
          "assigningOrganizationIdentificationCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120,
            "description": "The organization code or name assigning the course identification code."
          },
          "courseCatalogURL": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The URL for the course catalog that defines the course identification code."
          },
          "earnedCredits": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits or units of value awarded for the completion of a course."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value awarded for the completion of a course."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value awarded for the completion of a course."
          },
          "attemptedCredits": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "credits": {
                "type": "number",
                "description": "The value of credits or units of value attempted."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value attempted."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value attempted for a course."
          },
          "whenTakenGradeLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The student's grade level at time of course."
          },
          "methodCreditEarnedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The method the credits were earned (e.g., Classroom, Transferred)."
          },
          "courseRepeatCodeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Indicates that an academic course has been repeated by a student and how that repeat is to be computed in the student's academic record."
          },
          "academicSubjects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area (e.g., Mathematics, Science, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject area associated with a course transcript record, discriminated by the academic subject descriptor. Collection child of CourseTranscript. Items unique by (academicSubjectDescriptor)."
          },
          "alternativeCourseIdentificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "courseIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A system that is used to identify the organization of subject matter and related learning experiences provided for the instruction of students (e.g., State course code, University course code)."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The alternative course identification code."
                }
              },
              "required": [
                "courseIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An alternative identification code for a course on a transcript, discriminated by the course identification system descriptor. Collection child of CourseTranscript. Items unique by (courseIdentificationSystemDescriptor)."
          },
          "coursePrograms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "courseProgramName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "The formal name of the program of studies associated with the course on the student's transcript."
                },
                "courseProgramTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Special Education, Bilingual, Career and Technical Education)."
                }
              },
              "required": [
                "courseProgramName",
                "courseProgramTypeDescriptor"
              ]
            },
            "description": "A program associated with a course on a transcript, discriminated by program name and program type descriptor. Collection child of CourseTranscript. Items unique by (courseProgramName, courseProgramTypeDescriptor)."
          },
          "creditCategories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "creditCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A categorization for the course transcript credits awarded (e.g., Honors, AP, IB)."
                }
              },
              "required": [
                "creditCategoryDescriptor"
              ]
            },
            "description": "A credit category associated with a course transcript record, discriminated by the credit category descriptor. Collection child of CourseTranscript. Items unique by (creditCategoryDescriptor)."
          },
          "earnedAdditionalCredits": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "additionalCreditTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of additional credits earned (e.g., Advanced Placement, International Baccalaureate)."
                },
                "credits": {
                  "type": "number",
                  "description": "The value of additional credits or units of value earned."
                }
              },
              "required": [
                "additionalCreditTypeDescriptor",
                "credits"
              ]
            },
            "description": "Additional credits earned by a student for a course transcript, discriminated by the additional credit type descriptor. Collection child of CourseTranscript. Items unique by (additionalCreditTypeDescriptor)."
          },
          "partialCourseTranscriptAwards": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "awardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the partial course transcript credits were awarded or earned."
                },
                "methodCreditEarnedDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The method the credits were earned (e.g., Classroom, Transferred)."
                },
                "letterGradeEarned": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 20,
                  "description": "The indicator of student performance for the partial course transcript award."
                },
                "earnedCredits": {
                  "type": "number",
                  "description": "The value of credits or units of value awarded for the partial course."
                }
              },
              "required": [
                "awardDate",
                "methodCreditEarnedDescriptor",
                "letterGradeEarned",
                "earnedCredits"
              ]
            },
            "description": "A partial course transcript award representing credits earned for a portion of a course, discriminated by award date, method credit earned descriptor, and letter grade earned. Collection child of CourseTranscript. Items unique by (awardDate, methodCreditEarnedDescriptor, letterGradeEarned)."
          },
          "sections": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The local identifier assigned to a section."
                },
                "schoolSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster organization sourcedId of the school offering the section."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The local code assigned by the school that identifies the course offering."
                },
                "sectionSchoolYear": {
                  "type": "integer",
                  "description": "The school year of the section."
                },
                "sectionTermDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The term descriptor for the section's session."
                }
              },
              "required": [
                "sectionIdentifier",
                "schoolSourcedId",
                "localCourseCode",
                "sectionSchoolYear",
                "sectionTermDescriptor"
              ]
            },
            "description": "An optional section reference associated with a course transcript, identifying the specific section in which the student was enrolled. Discriminated by section identifier, school, local course code, section school year, and term descriptor. Collection child of CourseTranscript. Items unique by (sectionIdentifier, schoolSourcedId, localCourseCode, sectionSchoolYear, sectionTermDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateCredentialRequest": {
        "type": "object",
        "description": "Create-Credential request body (readOnly/server-managed fields excluded).",
        "required": [
          "credentialIdentifier",
          "stateOfIssueStateAbbreviationDescriptor",
          "namespace",
          "credentialTypeDescriptor",
          "issuanceDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "credentialIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the credential."
          },
          "stateOfIssueStateAbbreviationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The abbreviation for the name of the state or extra-state jurisdiction in which a license/credential was issued."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the credential."
          },
          "credentialTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the category of the credential a person holds."
          },
          "issuanceDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an active credential was issued to a person."
          },
          "credentialFieldDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The field of certification for the credential."
          },
          "effectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an active credential held by a person was issued."
          },
          "expirationDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an active credential held by a person will expire."
          },
          "teachingCredentialDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indication of the category of a legal document giving authorization to perform teaching assignment services."
          },
          "teachingCredentialBasisDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indication of the pre-determined criteria for granting the teaching credential."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level certified for teaching."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade level(s) certified for teaching. Folded descriptor collection."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject to which the credential pertains."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "The academic subjects to which the credential pertains. Folded descriptor collection."
          },
          "endorsements": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "credentialEndorsement": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Endorsement attached to teaching certificates indicating areas of specialization."
                }
              },
              "required": [
                "credentialEndorsement"
              ]
            },
            "description": "Endorsements attached to teaching certificates. Folded string collection."
          },
          "certificationTitle": {
            "type": "string",
            "maxLength": 64,
            "description": "The title of the certification obtained by the person."
          },
          "certificationIdentifier": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional reference to the certification associated with the person's credential.",
            "x-references": "certification.certificationIdentifier",
            "x-references-legs": [
              "certificationNamespace"
            ],
            "x-onDelete": "restrict"
          },
          "certificationNamespace": {
            "type": "string",
            "maxLength": 255,
            "description": "Namespace leg of the optional certification reference."
          },
          "certificationRouteDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The process, program, or pathway used to obtain certification."
          },
          "boardCertificationIndicator": {
            "type": "boolean",
            "description": "Indicator that the credential was granted under the authority of a national board certification."
          },
          "credentialStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The current status of the credential."
          },
          "credentialStatusDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the credential status was effective."
          },
          "personId": {
            "type": "string",
            "maxLength": 32,
            "description": "The person who obtained and is holding the credential (person natural-key leg).",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Source system leg of the optional person reference."
          },
          "studentAcademicRecords": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student sourcedId leg of studentAcademicRecord."
                },
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization leg of studentAcademicRecord."
                },
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "School year leg of studentAcademicRecord."
                },
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term descriptor leg of studentAcademicRecord."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationId",
                "schoolYear",
                "termDescriptor"
              ]
            },
            "description": "Optional student academic records associated with the credential. Folded collection; FK validated at command layer."
          },
          "educatorRoleDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The specific roles or positions the credential is intended to authorize."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCredentialRequest": {
        "type": "object",
        "description": "Update-Credential request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "credentialIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier or serial number assigned to the credential."
          },
          "stateOfIssueStateAbbreviationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The abbreviation for the name of the state or extra-state jurisdiction in which a license/credential was issued."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace for the credential."
          },
          "credentialTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the category of the credential a person holds."
          },
          "issuanceDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an active credential was issued to a person."
          },
          "credentialFieldDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The field of certification for the credential."
          },
          "effectiveDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which an active credential held by a person was issued."
          },
          "expirationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which an active credential held by a person will expire."
          },
          "teachingCredentialDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "An indication of the category of a legal document giving authorization to perform teaching assignment services."
          },
          "teachingCredentialBasisDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "An indication of the pre-determined criteria for granting the teaching credential."
          },
          "gradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level certified for teaching."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade level(s) certified for teaching. Folded descriptor collection."
          },
          "academicSubjects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject to which the credential pertains."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "The academic subjects to which the credential pertains. Folded descriptor collection."
          },
          "endorsements": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "credentialEndorsement": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Endorsement attached to teaching certificates indicating areas of specialization."
                }
              },
              "required": [
                "credentialEndorsement"
              ]
            },
            "description": "Endorsements attached to teaching certificates. Folded string collection."
          },
          "certificationTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 64,
            "description": "The title of the certification obtained by the person."
          },
          "certificationIdentifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120,
            "description": "Optional reference to the certification associated with the person's credential.",
            "x-references": "certification.certificationIdentifier",
            "x-references-legs": [
              "certificationNamespace"
            ],
            "x-onDelete": "restrict"
          },
          "certificationNamespace": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Namespace leg of the optional certification reference."
          },
          "certificationRouteDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The process, program, or pathway used to obtain certification."
          },
          "boardCertificationIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator that the credential was granted under the authority of a national board certification."
          },
          "credentialStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The current status of the credential."
          },
          "credentialStatusDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the credential status was effective."
          },
          "personId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The person who obtained and is holding the credential (person natural-key leg).",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Source system leg of the optional person reference."
          },
          "studentAcademicRecords": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student sourcedId leg of studentAcademicRecord."
                },
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization leg of studentAcademicRecord."
                },
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "School year leg of studentAcademicRecord."
                },
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term descriptor leg of studentAcademicRecord."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationId",
                "schoolYear",
                "termDescriptor"
              ]
            },
            "description": "Optional student academic records associated with the credential. Folded collection; FK validated at command layer."
          },
          "educatorRoleDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The specific roles or positions the credential is intended to authorize."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCredentialEventRequest": {
        "type": "object",
        "description": "Create-CredentialEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "credentialIdentifier",
          "stateOfIssueStateAbbreviationDescriptor",
          "credentialEventDate",
          "credentialEventTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "credentialIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Credential identifier (credential natural-key leg).",
            "x-references": "credential.credentialIdentifier",
            "x-references-legs": [
              "stateOfIssueStateAbbreviationDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "stateOfIssueStateAbbreviationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "State of issue leg of the credential natural key."
          },
          "credentialEventDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year of the credential event."
          },
          "credentialEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of event associated with a person's credential."
          },
          "credentialEventReason": {
            "type": "string",
            "maxLength": 1024,
            "description": "The reason for the credential event, or any other descriptive text."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCredentialEventRequest": {
        "type": "object",
        "description": "Update-CredentialEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "credentialIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Credential identifier (credential natural-key leg).",
            "x-references": "credential.credentialIdentifier",
            "x-references-legs": [
              "stateOfIssueStateAbbreviationDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "stateOfIssueStateAbbreviationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "State of issue leg of the credential natural key."
          },
          "credentialEventDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year of the credential event."
          },
          "credentialEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of event associated with a person's credential."
          },
          "credentialEventReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "The reason for the credential event, or any other descriptive text."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateCrisisEventRequest": {
        "type": "object",
        "description": "Create-CrisisEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "crisisEventName",
          "crisisTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "crisisEventName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name of the crisis event that occurred. Suggested format when no accepted name: Location + Crisis type + Year."
          },
          "crisisTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type or category of crisis."
          },
          "crisisDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Provides a textual description of the crisis event."
          },
          "crisisStartDate": {
            "type": "string",
            "format": "date",
            "description": "The year, month and day on which the crisis affected the student."
          },
          "crisisEndDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the crisis ceased to affect the student."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateCrisisEventRequest": {
        "type": "object",
        "description": "Update-CrisisEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "crisisEventName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name of the crisis event that occurred. Suggested format when no accepted name: Location + Crisis type + Year."
          },
          "crisisTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type or category of crisis."
          },
          "crisisDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Provides a textual description of the crisis event."
          },
          "crisisStartDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The year, month and day on which the crisis affected the student."
          },
          "crisisEndDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date on which the crisis ceased to affect the student."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateDescriptorRequest": {
        "type": "object",
        "description": "Create-Descriptor request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "codeValue",
          "descriptorType",
          "shortDescription",
          "standardStatus"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The Ed-Fi namespace URI that scopes this descriptor value (e.g. `uri://ed-fi.org/AcademicHonorCategoryDescriptor`)."
          },
          "codeValue": {
            "type": "string",
            "minLength": 1,
            "maxLength": 150,
            "description": "The short machine-readable code for this descriptor value within its namespace."
          },
          "descriptorType": {
            "type": "string",
            "enum": [
              "AbsenceEventCategoryDescriptor",
              "AcademicHonorCategoryDescriptor",
              "AcademicSubjectDescriptor",
              "AccommodationDescriptor",
              "AccountClassificationDescriptor",
              "AccountTypeDescriptor",
              "AchievementCategoryDescriptor",
              "AdditionalCreditTypeDescriptor",
              "AddressTypeDescriptor",
              "AdministrativeFundingControlDescriptor",
              "AssessmentCategoryDescriptor",
              "AssessmentIdentificationSystemDescriptor",
              "AssessmentItemCategoryDescriptor",
              "AssessmentItemResultDescriptor",
              "AssessmentPeriodDescriptor",
              "AssessmentReportingMethodDescriptor",
              "AssessmentScoreRangeLearningStandardDescriptor",
              "AttemptStatusDescriptor",
              "AttendanceEventCategoryDescriptor",
              "BarrierToInternetAccessInResidenceDescriptor",
              "BehaviorDescriptor",
              "CalendarEventDescriptor",
              "CalendarTypeDescriptor",
              "CareerPathwayDescriptor",
              "CharterApprovalAgencyTypeDescriptor",
              "CharterStatusDescriptor",
              "CitizenshipStatusDescriptor",
              "ClassroomPositionDescriptor",
              "CohortScopeDescriptor",
              "CohortTypeDescriptor",
              "CohortYearTypeDescriptor",
              "CompetencyLevelDescriptor",
              "ContactTypeDescriptor",
              "ContentClassDescriptor",
              "ContinuationOfServicesReasonDescriptor",
              "CostRateDescriptor",
              "CountryDescriptor",
              "CourseAttemptResultDescriptor",
              "CourseDefinedByDescriptor",
              "CourseGPAApplicabilityDescriptor",
              "CourseIdentificationSystemDescriptor",
              "CourseLevelCharacteristicDescriptor",
              "CourseRepeatCodeDescriptor",
              "CredentialFieldDescriptor",
              "CredentialTypeDescriptor",
              "CreditCategoryDescriptor",
              "CreditTypeDescriptor",
              "CurriculumUsedDescriptor",
              "DeliveryMethodDescriptor",
              "DiagnosisDescriptor",
              "DiplomaLevelDescriptor",
              "DiplomaTypeDescriptor",
              "DisabilityDescriptor",
              "DisabilityDesignationDescriptor",
              "DisabilityDeterminationSourceTypeDescriptor",
              "DisciplineActionLengthDifferenceReasonDescriptor",
              "DisciplineDescriptor",
              "EducationOrganizationCategoryDescriptor",
              "EducationOrganizationIdentificationSystemDescriptor",
              "EducationPlanDescriptor",
              "ElectronicMailTypeDescriptor",
              "EmploymentStatusDescriptor",
              "EntryGradeLevelReasonDescriptor",
              "EntryTypeDescriptor",
              "EventCircumstanceDescriptor",
              "ExitWithdrawTypeDescriptor",
              "FinancialCollectionDescriptor",
              "GradeLevelDescriptor",
              "GradePointAverageTypeDescriptor",
              "GradeTypeDescriptor",
              "GradebookEntryTypeDescriptor",
              "GradingPeriodDescriptor",
              "GraduationPlanTypeDescriptor",
              "GunFreeSchoolsActReportingStatusDescriptor",
              "HomelessPrimaryNighttimeResidenceDescriptor",
              "HomelessProgramServiceDescriptor",
              "IdentificationDocumentUseDescriptor",
              "IncidentLocationDescriptor",
              "InstitutionTelephoneNumberTypeDescriptor",
              "InteractivityStyleDescriptor",
              "InternetAccessDescriptor",
              "InternetAccessTypeInResidenceDescriptor",
              "InternetPerformanceInResidenceDescriptor",
              "InterventionClassDescriptor",
              "InterventionEffectivenessRatingDescriptor",
              "LanguageDescriptor",
              "LanguageInstructionProgramServiceDescriptor",
              "LanguageUseDescriptor",
              "LearningStandardCategoryDescriptor",
              "LearningStandardEquivalenceStrengthDescriptor",
              "LearningStandardScopeDescriptor",
              "LevelOfEducationDescriptor",
              "LicenseStatusDescriptor",
              "LicenseTypeDescriptor",
              "LimitedEnglishProficiencyDescriptor",
              "LocaleDescriptor",
              "LocalEducationAgencyCategoryDescriptor",
              "MagnetSpecialProgramEmphasisSchoolDescriptor",
              "MediumOfInstructionDescriptor",
              "MethodCreditEarnedDescriptor",
              "MigrantEducationProgramServiceDescriptor",
              "MonitoredDescriptor",
              "NeglectedOrDelinquentProgramDescriptor",
              "NeglectedOrDelinquentProgramServiceDescriptor",
              "NetworkPurposeDescriptor",
              "NonMedicalImmunizationExemptionDescriptor",
              "OperationalStatusDescriptor",
              "OtherNameTypeDescriptor",
              "ParticipationDescriptor",
              "ParticipationStatusDescriptor",
              "PerformanceBaseConversionDescriptor",
              "PerformanceLevelDescriptor",
              "PersonalInformationVerificationDescriptor",
              "PlatformTypeDescriptor",
              "PopulationServedDescriptor",
              "PostingResultDescriptor",
              "PostSecondaryEventCategoryDescriptor",
              "PostSecondaryInstitutionLevelDescriptor",
              "PrimaryLearningDeviceAccessDescriptor",
              "PrimaryLearningDeviceAwayFromSchoolDescriptor",
              "PrimaryLearningDeviceProviderDescriptor",
              "ProficiencyDescriptor",
              "ProgramAssignmentDescriptor",
              "ProgramCharacteristicDescriptor",
              "ProgramSponsorDescriptor",
              "ProgramTypeDescriptor",
              "ProgressDescriptor",
              "ProgressLevelDescriptor",
              "ProviderCategoryDescriptor",
              "ProviderProfitabilityDescriptor",
              "ProviderStatusDescriptor",
              "PublicationStatusDescriptor",
              "QuestionFormDescriptor",
              "RaceDescriptor",
              "ReasonExitedDescriptor",
              "ReasonNotTestedDescriptor",
              "RecognitionTypeDescriptor",
              "RelationDescriptor",
              "RepeatIdentifierDescriptor",
              "ReporterDescriptionDescriptor",
              "ResidencyStatusDescriptor",
              "ResponseIndicatorDescriptor",
              "ResponsibilityDescriptor",
              "RestraintEventReasonDescriptor",
              "ResultDatatypeTypeDescriptor",
              "RetestIndicatorDescriptor",
              "SchoolCategoryDescriptor",
              "SchoolChoiceImplementStatusDescriptor",
              "SchoolFoodServiceProgramServiceDescriptor",
              "SchoolTypeDescriptor",
              "SectionCharacteristicDescriptor",
              "SeparationDescriptor",
              "SeparationReasonDescriptor",
              "ServiceDescriptor",
              "SexDescriptor",
              "SourceSystemDescriptor",
              "SpecialEducationProgramServiceDescriptor",
              "SpecialEducationSettingDescriptor",
              "StaffClassificationDescriptor",
              "StaffIdentificationSystemDescriptor",
              "StaffLeaveEventCategoryDescriptor",
              "StateAbbreviationDescriptor",
              "StudentCharacteristicDescriptor",
              "StudentIdentificationSystemDescriptor",
              "StudentParticipationCodeDescriptor",
              "SurveyLevelDescriptor",
              "TeachingCredentialBasisDescriptor",
              "TeachingCredentialDescriptor",
              "TechnicalSkillsAssessmentDescriptor",
              "TelephoneNumberTypeDescriptor",
              "TermDescriptor",
              "TitleIPartAParticipantDescriptor",
              "TitleIPartASchoolDesignationDescriptor",
              "TribalAffiliationDescriptor",
              "VisaDescriptor",
              "WeaponDescriptor",
              "AncestryEthnicOriginDescriptor",
              "AssessmentLanguageDescriptor",
              "BalanceSheetDimensionDescriptor",
              "BusRouteDescriptor",
              "CalendarDescriptor",
              "ChartOfAccountIdentificationSystemDescriptor",
              "CoteachingStyleObservedDescriptor",
              "CTEProgramServiceDescriptor",
              "DisciplineIncidentParticipationCodeDescriptor",
              "EducatorRoleDescriptor",
              "EligibilityDelayReasonDescriptor",
              "EligibilityEvaluationTypeDescriptor",
              "EnrollmentTypeDescriptor",
              "EvaluationDelayReasonDescriptor",
              "EvaluationElementRatingLevelDescriptor",
              "EvaluationPeriodDescriptor",
              "EvaluationRatingLevelDescriptor",
              "EvaluationRatingStatusDescriptor",
              "EvaluationTypeDescriptor",
              "FunctionDimensionDescriptor",
              "FundDimensionDescriptor",
              "GeneralStudentProgramAssociationParticipationStatusDescriptor",
              "GiftedTalentedParticipationDescriptor",
              "GraduationPlanCategoryDescriptor",
              "HandicapTypeDescriptor",
              "IDEAPartDescriptor",
              "ImmunizationDateDescriptor",
              "ImmunizationTypeDescriptor",
              "IndicatorDescriptor",
              "IndicatorGroupDescriptor",
              "IndicatorLevelDescriptor",
              "InstructionalApproachDescriptor",
              "InstructionalDeliveryModeDescriptor",
              "LevelDescriptor",
              "LevelOfEducationGrantedDescriptor",
              "LocalAccountDescriptor",
              "ObjectDimensionDescriptor",
              "ObjectiveAssessmentAcademicSubjectDescriptor",
              "OperationalUnitDimensionDescriptor",
              "ProblemTypeDescriptor",
              "ProgramDimensionDescriptor",
              "ProjectDimensionDescriptor",
              "ProviderTypeDescriptor",
              "QuestionFormTypeDescriptor",
              "RatingLevelDescriptor",
              "ReportingTagDescriptor",
              "SchoolYearTypeDescriptor",
              "SectionTypeDescriptor",
              "SourceDimensionDescriptor",
              "SpecialEducationExitReasonDescriptor",
              "StudentGrowthTypeDescriptor",
              "SubmissionStatusDescriptor",
              "SurveyCategoryDescriptor",
              "SurveyResponseIndicatorDescriptor",
              "SurveySectionAssociationDescriptor",
              "TitleIPartAProgramServiceDescriptor",
              "TransportationPublicExpenseEligibilityTypeDescriptor",
              "TransportationTypeDescriptor",
              "TravelDayofWeekDescriptor",
              "TravelDirectionDescriptor",
              "WebServiceDescriptor"
            ],
            "description": "The Ed-Fi descriptor type this value belongs to. Discriminates over all 280 descriptor types in Data Standard v6.1."
          },
          "shortDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "A brief label for this descriptor value suitable for dropdowns and compact displays."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "A longer explanatory description of what this descriptor value means."
          },
          "effectiveBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The date this descriptor value became valid for use in the system."
          },
          "effectiveEndDate": {
            "type": "string",
            "format": "date",
            "description": "The date after which this descriptor value is no longer valid for new writes."
          },
          "standardStatus": {
            "type": "string",
            "enum": [
              "ed_fi_standard",
              "district_local",
              "platform_extension"
            ],
            "description": "Governance tier for this descriptor value: `ed_fi_standard` ships with the Ed-Fi Data Standard, `district_local` is a district-authored extension, `platform_extension` is an Alpha platform addition."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this descriptor value. Descriptors are typically `canonical` on creation; `soft_deleted` when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this descriptor is deleted: `api` for user-initiated DELETE, `import` for removal during a bulk import, `correction` for administrative data correction, `retention_policy` for automated retention sweeps."
          }
        }
      },
      "UpdateDescriptorRequest": {
        "type": "object",
        "description": "Update-Descriptor request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The Ed-Fi namespace URI that scopes this descriptor value (e.g. `uri://ed-fi.org/AcademicHonorCategoryDescriptor`)."
          },
          "codeValue": {
            "type": "string",
            "minLength": 1,
            "maxLength": 150,
            "description": "The short machine-readable code for this descriptor value within its namespace."
          },
          "descriptorType": {
            "type": "string",
            "enum": [
              "AbsenceEventCategoryDescriptor",
              "AcademicHonorCategoryDescriptor",
              "AcademicSubjectDescriptor",
              "AccommodationDescriptor",
              "AccountClassificationDescriptor",
              "AccountTypeDescriptor",
              "AchievementCategoryDescriptor",
              "AdditionalCreditTypeDescriptor",
              "AddressTypeDescriptor",
              "AdministrativeFundingControlDescriptor",
              "AssessmentCategoryDescriptor",
              "AssessmentIdentificationSystemDescriptor",
              "AssessmentItemCategoryDescriptor",
              "AssessmentItemResultDescriptor",
              "AssessmentPeriodDescriptor",
              "AssessmentReportingMethodDescriptor",
              "AssessmentScoreRangeLearningStandardDescriptor",
              "AttemptStatusDescriptor",
              "AttendanceEventCategoryDescriptor",
              "BarrierToInternetAccessInResidenceDescriptor",
              "BehaviorDescriptor",
              "CalendarEventDescriptor",
              "CalendarTypeDescriptor",
              "CareerPathwayDescriptor",
              "CharterApprovalAgencyTypeDescriptor",
              "CharterStatusDescriptor",
              "CitizenshipStatusDescriptor",
              "ClassroomPositionDescriptor",
              "CohortScopeDescriptor",
              "CohortTypeDescriptor",
              "CohortYearTypeDescriptor",
              "CompetencyLevelDescriptor",
              "ContactTypeDescriptor",
              "ContentClassDescriptor",
              "ContinuationOfServicesReasonDescriptor",
              "CostRateDescriptor",
              "CountryDescriptor",
              "CourseAttemptResultDescriptor",
              "CourseDefinedByDescriptor",
              "CourseGPAApplicabilityDescriptor",
              "CourseIdentificationSystemDescriptor",
              "CourseLevelCharacteristicDescriptor",
              "CourseRepeatCodeDescriptor",
              "CredentialFieldDescriptor",
              "CredentialTypeDescriptor",
              "CreditCategoryDescriptor",
              "CreditTypeDescriptor",
              "CurriculumUsedDescriptor",
              "DeliveryMethodDescriptor",
              "DiagnosisDescriptor",
              "DiplomaLevelDescriptor",
              "DiplomaTypeDescriptor",
              "DisabilityDescriptor",
              "DisabilityDesignationDescriptor",
              "DisabilityDeterminationSourceTypeDescriptor",
              "DisciplineActionLengthDifferenceReasonDescriptor",
              "DisciplineDescriptor",
              "EducationOrganizationCategoryDescriptor",
              "EducationOrganizationIdentificationSystemDescriptor",
              "EducationPlanDescriptor",
              "ElectronicMailTypeDescriptor",
              "EmploymentStatusDescriptor",
              "EntryGradeLevelReasonDescriptor",
              "EntryTypeDescriptor",
              "EventCircumstanceDescriptor",
              "ExitWithdrawTypeDescriptor",
              "FinancialCollectionDescriptor",
              "GradeLevelDescriptor",
              "GradePointAverageTypeDescriptor",
              "GradeTypeDescriptor",
              "GradebookEntryTypeDescriptor",
              "GradingPeriodDescriptor",
              "GraduationPlanTypeDescriptor",
              "GunFreeSchoolsActReportingStatusDescriptor",
              "HomelessPrimaryNighttimeResidenceDescriptor",
              "HomelessProgramServiceDescriptor",
              "IdentificationDocumentUseDescriptor",
              "IncidentLocationDescriptor",
              "InstitutionTelephoneNumberTypeDescriptor",
              "InteractivityStyleDescriptor",
              "InternetAccessDescriptor",
              "InternetAccessTypeInResidenceDescriptor",
              "InternetPerformanceInResidenceDescriptor",
              "InterventionClassDescriptor",
              "InterventionEffectivenessRatingDescriptor",
              "LanguageDescriptor",
              "LanguageInstructionProgramServiceDescriptor",
              "LanguageUseDescriptor",
              "LearningStandardCategoryDescriptor",
              "LearningStandardEquivalenceStrengthDescriptor",
              "LearningStandardScopeDescriptor",
              "LevelOfEducationDescriptor",
              "LicenseStatusDescriptor",
              "LicenseTypeDescriptor",
              "LimitedEnglishProficiencyDescriptor",
              "LocaleDescriptor",
              "LocalEducationAgencyCategoryDescriptor",
              "MagnetSpecialProgramEmphasisSchoolDescriptor",
              "MediumOfInstructionDescriptor",
              "MethodCreditEarnedDescriptor",
              "MigrantEducationProgramServiceDescriptor",
              "MonitoredDescriptor",
              "NeglectedOrDelinquentProgramDescriptor",
              "NeglectedOrDelinquentProgramServiceDescriptor",
              "NetworkPurposeDescriptor",
              "NonMedicalImmunizationExemptionDescriptor",
              "OperationalStatusDescriptor",
              "OtherNameTypeDescriptor",
              "ParticipationDescriptor",
              "ParticipationStatusDescriptor",
              "PerformanceBaseConversionDescriptor",
              "PerformanceLevelDescriptor",
              "PersonalInformationVerificationDescriptor",
              "PlatformTypeDescriptor",
              "PopulationServedDescriptor",
              "PostingResultDescriptor",
              "PostSecondaryEventCategoryDescriptor",
              "PostSecondaryInstitutionLevelDescriptor",
              "PrimaryLearningDeviceAccessDescriptor",
              "PrimaryLearningDeviceAwayFromSchoolDescriptor",
              "PrimaryLearningDeviceProviderDescriptor",
              "ProficiencyDescriptor",
              "ProgramAssignmentDescriptor",
              "ProgramCharacteristicDescriptor",
              "ProgramSponsorDescriptor",
              "ProgramTypeDescriptor",
              "ProgressDescriptor",
              "ProgressLevelDescriptor",
              "ProviderCategoryDescriptor",
              "ProviderProfitabilityDescriptor",
              "ProviderStatusDescriptor",
              "PublicationStatusDescriptor",
              "QuestionFormDescriptor",
              "RaceDescriptor",
              "ReasonExitedDescriptor",
              "ReasonNotTestedDescriptor",
              "RecognitionTypeDescriptor",
              "RelationDescriptor",
              "RepeatIdentifierDescriptor",
              "ReporterDescriptionDescriptor",
              "ResidencyStatusDescriptor",
              "ResponseIndicatorDescriptor",
              "ResponsibilityDescriptor",
              "RestraintEventReasonDescriptor",
              "ResultDatatypeTypeDescriptor",
              "RetestIndicatorDescriptor",
              "SchoolCategoryDescriptor",
              "SchoolChoiceImplementStatusDescriptor",
              "SchoolFoodServiceProgramServiceDescriptor",
              "SchoolTypeDescriptor",
              "SectionCharacteristicDescriptor",
              "SeparationDescriptor",
              "SeparationReasonDescriptor",
              "ServiceDescriptor",
              "SexDescriptor",
              "SourceSystemDescriptor",
              "SpecialEducationProgramServiceDescriptor",
              "SpecialEducationSettingDescriptor",
              "StaffClassificationDescriptor",
              "StaffIdentificationSystemDescriptor",
              "StaffLeaveEventCategoryDescriptor",
              "StateAbbreviationDescriptor",
              "StudentCharacteristicDescriptor",
              "StudentIdentificationSystemDescriptor",
              "StudentParticipationCodeDescriptor",
              "SurveyLevelDescriptor",
              "TeachingCredentialBasisDescriptor",
              "TeachingCredentialDescriptor",
              "TechnicalSkillsAssessmentDescriptor",
              "TelephoneNumberTypeDescriptor",
              "TermDescriptor",
              "TitleIPartAParticipantDescriptor",
              "TitleIPartASchoolDesignationDescriptor",
              "TribalAffiliationDescriptor",
              "VisaDescriptor",
              "WeaponDescriptor",
              "AncestryEthnicOriginDescriptor",
              "AssessmentLanguageDescriptor",
              "BalanceSheetDimensionDescriptor",
              "BusRouteDescriptor",
              "CalendarDescriptor",
              "ChartOfAccountIdentificationSystemDescriptor",
              "CoteachingStyleObservedDescriptor",
              "CTEProgramServiceDescriptor",
              "DisciplineIncidentParticipationCodeDescriptor",
              "EducatorRoleDescriptor",
              "EligibilityDelayReasonDescriptor",
              "EligibilityEvaluationTypeDescriptor",
              "EnrollmentTypeDescriptor",
              "EvaluationDelayReasonDescriptor",
              "EvaluationElementRatingLevelDescriptor",
              "EvaluationPeriodDescriptor",
              "EvaluationRatingLevelDescriptor",
              "EvaluationRatingStatusDescriptor",
              "EvaluationTypeDescriptor",
              "FunctionDimensionDescriptor",
              "FundDimensionDescriptor",
              "GeneralStudentProgramAssociationParticipationStatusDescriptor",
              "GiftedTalentedParticipationDescriptor",
              "GraduationPlanCategoryDescriptor",
              "HandicapTypeDescriptor",
              "IDEAPartDescriptor",
              "ImmunizationDateDescriptor",
              "ImmunizationTypeDescriptor",
              "IndicatorDescriptor",
              "IndicatorGroupDescriptor",
              "IndicatorLevelDescriptor",
              "InstructionalApproachDescriptor",
              "InstructionalDeliveryModeDescriptor",
              "LevelDescriptor",
              "LevelOfEducationGrantedDescriptor",
              "LocalAccountDescriptor",
              "ObjectDimensionDescriptor",
              "ObjectiveAssessmentAcademicSubjectDescriptor",
              "OperationalUnitDimensionDescriptor",
              "ProblemTypeDescriptor",
              "ProgramDimensionDescriptor",
              "ProjectDimensionDescriptor",
              "ProviderTypeDescriptor",
              "QuestionFormTypeDescriptor",
              "RatingLevelDescriptor",
              "ReportingTagDescriptor",
              "SchoolYearTypeDescriptor",
              "SectionTypeDescriptor",
              "SourceDimensionDescriptor",
              "SpecialEducationExitReasonDescriptor",
              "StudentGrowthTypeDescriptor",
              "SubmissionStatusDescriptor",
              "SurveyCategoryDescriptor",
              "SurveyResponseIndicatorDescriptor",
              "SurveySectionAssociationDescriptor",
              "TitleIPartAProgramServiceDescriptor",
              "TransportationPublicExpenseEligibilityTypeDescriptor",
              "TransportationTypeDescriptor",
              "TravelDayofWeekDescriptor",
              "TravelDirectionDescriptor",
              "WebServiceDescriptor"
            ],
            "description": "The Ed-Fi descriptor type this value belongs to. Discriminates over all 280 descriptor types in Data Standard v6.1."
          },
          "shortDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "A brief label for this descriptor value suitable for dropdowns and compact displays."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "A longer explanatory description of what this descriptor value means."
          },
          "effectiveBeginDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date this descriptor value became valid for use in the system."
          },
          "effectiveEndDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date after which this descriptor value is no longer valid for new writes."
          },
          "standardStatus": {
            "type": "string",
            "enum": [
              "ed_fi_standard",
              "district_local",
              "platform_extension"
            ],
            "description": "Governance tier for this descriptor value: `ed_fi_standard` ships with the Ed-Fi Data Standard, `district_local` is a district-authored extension, `platform_extension` is an Alpha platform addition."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this descriptor value. Descriptors are typically `canonical` on creation; `soft_deleted` when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this descriptor is deleted: `api` for user-initiated DELETE, `import` for removal during a bulk import, `correction` for administrative data correction, `retention_policy` for automated retention sweeps."
          }
        }
      },
      "CreateDescriptorMappingRequest": {
        "type": "object",
        "description": "Create-DescriptorMapping request body (readOnly/server-managed fields excluded).",
        "required": [
          "value",
          "namespace",
          "mappedValue",
          "mappedNamespace",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "value": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The descriptor value being mapped from."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the source descriptor value."
          },
          "mappedValue": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The descriptor value being mapped to."
          },
          "mappedNamespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the target descriptor value."
          },
          "modelEntities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "modelEntityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Model entity the mapping applies to."
                }
              },
              "required": [
                "modelEntityDescriptor"
              ],
              "description": "modelEntitiesItem value."
            },
            "description": "Resources for which the descriptor mapping applies. Empty means all resources."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateDescriptorMappingRequest": {
        "type": "object",
        "description": "Update-DescriptorMapping request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "value": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The descriptor value being mapped from."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the source descriptor value."
          },
          "mappedValue": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The descriptor value being mapped to."
          },
          "mappedNamespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the target descriptor value."
          },
          "modelEntities": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "modelEntityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Model entity the mapping applies to."
                }
              },
              "required": [
                "modelEntityDescriptor"
              ],
              "description": "modelEntitiesItem value."
            },
            "description": "Resources for which the descriptor mapping applies. Empty means all resources."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateDisciplineActionRequest": {
        "type": "object",
        "description": "Create-DisciplineAction request body (readOnly/server-managed fields excluded).",
        "required": [
          "disciplineActionIdentifier",
          "studentSourcedId",
          "assignedSchoolSourcedId",
          "disciplineDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "disciplineActionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "Identifier assigned by the education organization to the DisciplineAction."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who received the discipline action (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "assignedSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school to which the student was assigned at the time of the discipline action.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "disciplineDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the DisciplineAction."
          },
          "responsibilitySchoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school responsible for the student's discipline.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "disciplineActionLength": {
            "type": "number",
            "description": "The length of time in school days for the DisciplineAction."
          },
          "disciplineActionLengthDifferenceReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Indicates the reason for the difference, if any, between the official and actual discipline action length."
          },
          "actualDisciplineActionLength": {
            "type": "number",
            "description": "Indicates the actual length in school days of a student's disciplinary assignment."
          },
          "iepPlacementMeetingIndicator": {
            "type": "boolean",
            "description": "An indication of whether an Individualized Education Program (IEP) meeting was held concerning the discipline action."
          },
          "relatedToZeroTolerancePolicy": {
            "type": "boolean",
            "description": "An indication of whether the discipline action was taken as a consequence of a zero-tolerance policy violation."
          },
          "receivedEducationServicesDuringExpulsion": {
            "type": "boolean",
            "description": "An indication of whether the student received educational services when removed from the regular school program for disciplinary reasons."
          },
          "disciplines": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disciplineDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of discipline applied (e.g., In School Suspension, Out of School Suspension, Expulsion)."
                }
              },
              "required": [
                "disciplineDescriptor"
              ]
            },
            "description": "The type of discipline (e.g., in-school suspension, out-of-school suspension) associated with a discipline action. Collection child of DisciplineAction. Items unique by (disciplineDescriptor)."
          },
          "staffs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "staffSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster user sourcedId identifying the staff member associated with this discipline action. References `oneroster:user.sourcedId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                }
              },
              "required": [
                "staffSourcedId"
              ]
            },
            "description": "A staff member associated with a discipline action. Collection child of DisciplineAction, keyed on (tenant, disciplineActionIdentifier, studentSourcedId, assignedSchoolSourcedId, disciplineDate, staffSourcedId). Items unique by (staffSourcedId)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this discipline action record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateDisciplineActionRequest": {
        "type": "object",
        "description": "Update-DisciplineAction request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "disciplineActionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "Identifier assigned by the education organization to the DisciplineAction."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who received the discipline action (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "assignedSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school to which the student was assigned at the time of the discipline action.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "disciplineDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the DisciplineAction."
          },
          "responsibilitySchoolSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school responsible for the student's discipline.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "disciplineActionLength": {
            "type": [
              "number",
              "null"
            ],
            "description": "The length of time in school days for the DisciplineAction."
          },
          "disciplineActionLengthDifferenceReasonDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Indicates the reason for the difference, if any, between the official and actual discipline action length."
          },
          "actualDisciplineActionLength": {
            "type": [
              "number",
              "null"
            ],
            "description": "Indicates the actual length in school days of a student's disciplinary assignment."
          },
          "iepPlacementMeetingIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication of whether an Individualized Education Program (IEP) meeting was held concerning the discipline action."
          },
          "relatedToZeroTolerancePolicy": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication of whether the discipline action was taken as a consequence of a zero-tolerance policy violation."
          },
          "receivedEducationServicesDuringExpulsion": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication of whether the student received educational services when removed from the regular school program for disciplinary reasons."
          },
          "disciplines": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "disciplineDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of discipline applied (e.g., In School Suspension, Out of School Suspension, Expulsion)."
                }
              },
              "required": [
                "disciplineDescriptor"
              ]
            },
            "description": "The type of discipline (e.g., in-school suspension, out-of-school suspension) associated with a discipline action. Collection child of DisciplineAction. Items unique by (disciplineDescriptor)."
          },
          "staffs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "staffSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster user sourcedId identifying the staff member associated with this discipline action. References `oneroster:user.sourcedId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                }
              },
              "required": [
                "staffSourcedId"
              ]
            },
            "description": "A staff member associated with a discipline action. Collection child of DisciplineAction, keyed on (tenant, disciplineActionIdentifier, studentSourcedId, assignedSchoolSourcedId, disciplineDate, staffSourcedId). Items unique by (staffSourcedId)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this discipline action record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateDisciplineIncidentRequest": {
        "type": "object",
        "description": "Create-DisciplineIncident request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "incidentIdentifier",
          "incidentDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify each specific DisciplineIncident."
          },
          "incidentDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the DisciplineIncident occurred."
          },
          "incidentTime": {
            "type": "string",
            "maxLength": 15,
            "description": "An indication of the time of day the incident took place."
          },
          "reporterDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Identifies the reporter of the discipline incident by use of a pre-existing enumeration value."
          },
          "reporterName": {
            "type": "string",
            "maxLength": 75,
            "description": "Identifies the reporter of the discipline incident by name."
          },
          "incidentLocationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Identifies where the DisciplineIncident occurred and whether it occurred on or off campus."
          },
          "staffSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member who reported the incident.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "caseNumber": {
            "type": "string",
            "maxLength": 20,
            "description": "The case number assigned to the DisciplineIncident by law enforcement or other agency."
          },
          "behaviors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "behaviorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Describes behavior by category and provides a detailed description."
                },
                "behaviorDetailedDescription": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "A detailed description of the specific behavior."
                }
              },
              "required": [
                "behaviorDescriptor"
              ]
            },
            "description": "A behavior associated with a discipline incident. Collection child of DisciplineIncident, keyed on (tenant, schoolSourcedId, incidentIdentifier, behaviorDescriptor). Items unique by (behaviorDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this discipline incident record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateDisciplineIncidentRequest": {
        "type": "object",
        "description": "Update-DisciplineIncident request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify each specific DisciplineIncident."
          },
          "incidentDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the DisciplineIncident occurred."
          },
          "incidentTime": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 15,
            "description": "An indication of the time of day the incident took place."
          },
          "reporterDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Identifies the reporter of the discipline incident by use of a pre-existing enumeration value."
          },
          "reporterName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "Identifies the reporter of the discipline incident by name."
          },
          "incidentLocationDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Identifies where the DisciplineIncident occurred and whether it occurred on or off campus."
          },
          "staffSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member who reported the incident.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "caseNumber": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 20,
            "description": "The case number assigned to the DisciplineIncident by law enforcement or other agency."
          },
          "behaviors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "behaviorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Describes behavior by category and provides a detailed description."
                },
                "behaviorDetailedDescription": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "A detailed description of the specific behavior."
                }
              },
              "required": [
                "behaviorDescriptor"
              ]
            },
            "description": "A behavior associated with a discipline incident. Collection child of DisciplineIncident, keyed on (tenant, schoolSourcedId, incidentIdentifier, behaviorDescriptor). Items unique by (behaviorDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this discipline incident record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEdfiDraftRecordRequest": {
        "type": "object",
        "description": "Create-EdfiDraftRecord request body (readOnly/server-managed fields excluded).",
        "required": [
          "resourceType",
          "payload",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "resourceType": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "The Ed-Fi resource type this draft represents (e.g. `studentSchoolAssociation`, `calendarDate`)."
          },
          "payload": {
            "type": "object",
            "description": "The full JSON payload of the draft resource, stored as-is before any validation or canonicalization."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this draft record. Only `draft` records are eligible for promotion.",
            "default": "draft"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this draft is deleted: `api` for user-initiated DELETE, `import` for removal during a bulk import, `correction` for administrative data correction, `retention_policy` for automated retention sweeps."
          }
        }
      },
      "CreateEducationContentRequest": {
        "type": "object",
        "description": "Create-EducationContent request body (readOnly/server-managed fields excluded).",
        "required": [
          "contentIdentifier",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "contentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 225,
            "description": "A unique identifier for the education content."
          },
          "learningResourceMetadataURI": {
            "type": "string",
            "maxLength": 255,
            "description": "The URI (typical combinator is a URL) pointing to the metadata entry in a LRMI metadata registry."
          },
          "shortDescription": {
            "type": "string",
            "maxLength": 75,
            "description": "A short description or name of the entity."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "An extended written representation of the education content."
          },
          "namespace": {
            "type": "string",
            "maxLength": 255,
            "description": "Namespace for the education content."
          },
          "publicationDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which this content was first published."
          },
          "publicationYear": {
            "type": "integer",
            "description": "The year at which this content was first published."
          },
          "publisher": {
            "type": "string",
            "maxLength": 50,
            "description": "The organization credited with publishing the resource."
          },
          "version": {
            "type": "string",
            "maxLength": 10,
            "description": "The version identifier for the content."
          },
          "timeRequired": {
            "type": "string",
            "maxLength": 30,
            "description": "Approximate or typical time it takes to work with or through this learning resource for the typical intended target audience."
          },
          "cost": {
            "type": "number",
            "description": "An amount that has to be paid or spent to buy or obtain the education content."
          },
          "costRate": {
            "type": "string",
            "maxLength": 306,
            "description": "The rate by which the cost applies (e.g., per student, per year)."
          },
          "interactivityStyle": {
            "type": "string",
            "maxLength": 306,
            "description": "The predominate mode of learning supported by the learning resource (e.g., active, expositive, mixed)."
          },
          "contentClass": {
            "type": "string",
            "maxLength": 306,
            "description": "The predominate type or kind characterizing the learning resource (e.g., presentation, handout, simulation)."
          },
          "useRightsURL": {
            "type": "string",
            "maxLength": 255,
            "description": "The URL where the owner specifies permissions for using the resource."
          },
          "appropriateGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which the education content is appropriate."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level for which an education content item is appropriate, discriminated by grade level descriptor. Collection child of EducationContent. Items unique by (gradeLevelDescriptor)."
          },
          "appropriateSexes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sexDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The sex for which the education content is appropriate."
                }
              },
              "required": [
                "sexDescriptor"
              ]
            },
            "description": "A sex for which an education content item is deemed appropriate, discriminated by sex descriptor. Collection child of EducationContent. Items unique by (sexDescriptor)."
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "author": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "The individual credited with the creation of the resource."
                }
              },
              "required": [
                "author"
              ]
            },
            "description": "An author attributed to an education content item, identified by author name. Collection child of EducationContent. Items unique by (author)."
          },
          "derivativeSourceEducationContents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "derivativeContentIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 225,
                  "description": "The content identifier of the source education content from which this content is derived."
                }
              },
              "required": [
                "derivativeContentIdentifier"
              ]
            },
            "description": "A reference to another education content item from which this content was derived, identified by derivative content identifier. Collection child of EducationContent. Items unique by (derivativeContentIdentifier)."
          },
          "derivativeSourceLearningResourceMetadataURIs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "derivativeLearningResourceMetadataURI": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The URI pointing to the LRMI metadata entry of the source learning resource."
                }
              },
              "required": [
                "derivativeLearningResourceMetadataURI"
              ]
            },
            "description": "A learning resource metadata URI from which an education content item was derived. Collection child of EducationContent. Items unique by (derivativeLearningResourceMetadataURI)."
          },
          "derivativeSourceURIs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "derivativeSourceURI": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The URI of the source from which this education content is derived."
                }
              },
              "required": [
                "derivativeSourceURI"
              ]
            },
            "description": "A generic URI from which an education content item was derived. Collection child of EducationContent. Items unique by (derivativeSourceURI)."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The language in which the education content is available."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language in which an education content item is available, discriminated by language descriptor. Collection child of EducationContent. Items unique by (languageDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateEducationContentRequest": {
        "type": "object",
        "description": "Update-EducationContent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "contentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 225,
            "description": "A unique identifier for the education content."
          },
          "learningResourceMetadataURI": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The URI (typical combinator is a URL) pointing to the metadata entry in a LRMI metadata registry."
          },
          "shortDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "A short description or name of the entity."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "An extended written representation of the education content."
          },
          "namespace": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Namespace for the education content."
          },
          "publicationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date on which this content was first published."
          },
          "publicationYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The year at which this content was first published."
          },
          "publisher": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 50,
            "description": "The organization credited with publishing the resource."
          },
          "version": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 10,
            "description": "The version identifier for the content."
          },
          "timeRequired": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "Approximate or typical time it takes to work with or through this learning resource for the typical intended target audience."
          },
          "cost": {
            "type": [
              "number",
              "null"
            ],
            "description": "An amount that has to be paid or spent to buy or obtain the education content."
          },
          "costRate": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The rate by which the cost applies (e.g., per student, per year)."
          },
          "interactivityStyle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The predominate mode of learning supported by the learning resource (e.g., active, expositive, mixed)."
          },
          "contentClass": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The predominate type or kind characterizing the learning resource (e.g., presentation, handout, simulation)."
          },
          "useRightsURL": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The URL where the owner specifies permissions for using the resource."
          },
          "appropriateGradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which the education content is appropriate."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level for which an education content item is appropriate, discriminated by grade level descriptor. Collection child of EducationContent. Items unique by (gradeLevelDescriptor)."
          },
          "appropriateSexes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "sexDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The sex for which the education content is appropriate."
                }
              },
              "required": [
                "sexDescriptor"
              ]
            },
            "description": "A sex for which an education content item is deemed appropriate, discriminated by sex descriptor. Collection child of EducationContent. Items unique by (sexDescriptor)."
          },
          "authors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "author": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "The individual credited with the creation of the resource."
                }
              },
              "required": [
                "author"
              ]
            },
            "description": "An author attributed to an education content item, identified by author name. Collection child of EducationContent. Items unique by (author)."
          },
          "derivativeSourceEducationContents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "derivativeContentIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 225,
                  "description": "The content identifier of the source education content from which this content is derived."
                }
              },
              "required": [
                "derivativeContentIdentifier"
              ]
            },
            "description": "A reference to another education content item from which this content was derived, identified by derivative content identifier. Collection child of EducationContent. Items unique by (derivativeContentIdentifier)."
          },
          "derivativeSourceLearningResourceMetadataURIs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "derivativeLearningResourceMetadataURI": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The URI pointing to the LRMI metadata entry of the source learning resource."
                }
              },
              "required": [
                "derivativeLearningResourceMetadataURI"
              ]
            },
            "description": "A learning resource metadata URI from which an education content item was derived. Collection child of EducationContent. Items unique by (derivativeLearningResourceMetadataURI)."
          },
          "derivativeSourceURIs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "derivativeSourceURI": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The URI of the source from which this education content is derived."
                }
              },
              "required": [
                "derivativeSourceURI"
              ]
            },
            "description": "A generic URI from which an education content item was derived. Collection child of EducationContent. Items unique by (derivativeSourceURI)."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The language in which the education content is available."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language in which an education content item is available, discriminated by language descriptor. Collection child of EducationContent. Items unique by (languageDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateEducationOrganizationRequest": {
        "type": "object",
        "description": "Create-EducationOrganization request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "nameOfInstitution",
          "categories",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full, legally accepted name of the institution."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 75,
            "description": "A short name for the institution."
          },
          "webSite": {
            "type": "string",
            "maxLength": 255,
            "description": "The public web site address (URL) for the education organization."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The current operational status of the education organization."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Education organization category."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ],
              "description": "categoriesItem value."
            },
            "description": "Education organization category classifications. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Physical or mailing addresses. Items unique by address natural key."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of institution telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "institutionTelephonesItem value."
            },
            "description": "Institution telephone numbers."
          },
          "indicators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "indicatorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicator type."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Who designated the indicator."
                },
                "indicatorValue": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "indicatorLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Indicator level."
                },
                "indicatorGroupDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Indicator group."
                }
              },
              "required": [
                "indicatorDescriptor"
              ],
              "description": "indicatorsItem value."
            },
            "description": "Education organization indicators/metrics."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEducationOrganizationRequest": {
        "type": "object",
        "description": "Update-EducationOrganization request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full, legally accepted name of the institution."
          },
          "shortNameOfInstitution": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "A short name for the institution."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The public web site address (URL) for the education organization."
          },
          "operationalStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The current operational status of the education organization."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Education organization category."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ],
              "description": "categoriesItem value."
            },
            "description": "Education organization category classifications. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Physical or mailing addresses. Items unique by address natural key."
          },
          "internationalAddresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of institution telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "institutionTelephonesItem value."
            },
            "description": "Institution telephone numbers."
          },
          "indicators": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "indicatorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicator type."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Who designated the indicator."
                },
                "indicatorValue": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Indicator value."
                },
                "indicatorLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Indicator level."
                },
                "indicatorGroupDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Indicator group."
                }
              },
              "required": [
                "indicatorDescriptor"
              ],
              "description": "indicatorsItem value."
            },
            "description": "Education organization indicators/metrics."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEducationOrganizationIdentificationCodeRequest": {
        "type": "object",
        "description": "Create-EducationOrganizationIdentificationCode request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "educationOrganizationIdentificationSystemDescriptor",
          "identificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization this identification code belongs to. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "educationOrganizationIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme used for identification and record-keeping."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an education organization."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The organization code or name assigning the identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEducationOrganizationIdentificationCodeRequest": {
        "type": "object",
        "description": "Update-EducationOrganizationIdentificationCode request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization this identification code belongs to. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "educationOrganizationIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme used for identification and record-keeping."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an education organization."
          },
          "assigningOrganizationIdentificationCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The organization code or name assigning the identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEducationOrganizationInterventionPrescriptionAssociationRequest": {
        "type": "object",
        "description": "Create-EducationOrganizationInterventionPrescriptionAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "interventionPrescriptionEducationOrganizationId",
          "interventionPrescriptionIdentificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization making the intervention prescription available to its hierarchy.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "interventionPrescriptionEducationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Education organization that defined the intervention prescription (interventionPrescription natural-key leg).",
            "x-references": "interventionPrescription.educationOrganizationId",
            "x-references-legs": [
              "interventionPrescriptionIdentificationCode"
            ],
            "x-onDelete": "restrict"
          },
          "interventionPrescriptionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Identification code of the intervention prescription."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the period during which the intervention prescription is available."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the period during which the intervention prescription is available."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEducationOrganizationInterventionPrescriptionAssociationRequest": {
        "type": "object",
        "description": "Update-EducationOrganizationInterventionPrescriptionAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization making the intervention prescription available to its hierarchy.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "interventionPrescriptionEducationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Education organization that defined the intervention prescription (interventionPrescription natural-key leg).",
            "x-references": "interventionPrescription.educationOrganizationId",
            "x-references-legs": [
              "interventionPrescriptionIdentificationCode"
            ],
            "x-onDelete": "restrict"
          },
          "interventionPrescriptionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Identification code of the intervention prescription."
          },
          "beginDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The begin date of the period during which the intervention prescription is available."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The end date of the period during which the intervention prescription is available."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEducationOrganizationNetworkRequest": {
        "type": "object",
        "description": "Create-EducationOrganizationNetwork request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationNetworkId",
          "nameOfInstitution",
          "networkPurposeDescriptor"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationNetworkId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The unique identifier for this education organization network within the tenant."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the education organization network."
          },
          "networkPurposeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The purpose of the network (e.g. Shared Services, Student Achievement). References the NetworkPurposeDescriptor governed value."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the network's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with an education organization network. A network may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this network. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for an education organization network. A network may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an education organization network by an external system. A network may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for an education organization network, classified by type (e.g. Main, Fax). A network may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this education organization network record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEducationOrganizationNetworkRequest": {
        "type": "object",
        "description": "Update-EducationOrganizationNetwork request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the education organization network."
          },
          "networkPurposeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The purpose of the network (e.g. Shared Services, Student Achievement). References the NetworkPurposeDescriptor governed value."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "The URL of the network's public website."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with an education organization network. A network may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this network. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for an education organization network. A network may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code. References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an education organization network by an external system. A network may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for an education organization network, classified by type (e.g. Main, Fax). A network may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this education organization network record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEducationOrganizationNetworkAssociationRequest": {
        "type": "object",
        "description": "Create-EducationOrganizationNetworkAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationNetworkId",
          "memberEducationOrganizationSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationNetworkId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization network.",
            "x-references": "educationOrganizationNetwork.educationOrganizationNetworkId",
            "x-onDelete": "cascade"
          },
          "memberEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The member education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the education organization joined this network."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the education organization left this network."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEducationOrganizationNetworkAssociationRequest": {
        "type": "object",
        "description": "Update-EducationOrganizationNetworkAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationNetworkId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization network.",
            "x-references": "educationOrganizationNetwork.educationOrganizationNetworkId",
            "x-onDelete": "cascade"
          },
          "memberEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The member education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "beginDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the education organization joined this network."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the education organization left this network."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEducationOrganizationPeerAssociationRequest": {
        "type": "object",
        "description": "Create-EducationOrganizationPeerAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "peerEducationOrganizationSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "peerEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The peer education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEducationOrganizationPeerAssociationRequest": {
        "type": "object",
        "description": "Update-EducationOrganizationPeerAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "peerEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The peer education organization. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "cascade"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEducationServiceCenterRequest": {
        "type": "object",
        "description": "Create-EducationServiceCenter request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationServiceCenterId",
          "nameOfInstitution"
        ],
        "additionalProperties": false,
        "properties": {
          "educationServiceCenterId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The unique identifier for this education service center within the tenant."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the education service center."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the education service center's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with an education service center. An ESC may have multiple addresses differentiated by address type (e.g. Physical, Mailing). The composite natural key includes the address type and core location fields to allow multiple addresses per ESC. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this education service center. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for an education service center. An ESC may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an education service center by an external system (e.g. NCES, state education agency). An ESC may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for an education service center, classified by type (e.g. Main, Fax). An ESC may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this education service center record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEducationServiceCenterRequest": {
        "type": "object",
        "description": "Update-EducationServiceCenter request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the education service center."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "The URL of the education service center's public website."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with an education service center. An ESC may have multiple addresses differentiated by address type (e.g. Physical, Mailing). The composite natural key includes the address type and core location fields to allow multiple addresses per ESC. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this education service center. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for an education service center. An ESC may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to an education service center by an external system (e.g. NCES, state education agency). An ESC may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for an education service center, classified by type (e.g. Main, Fax). An ESC may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this education service center record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEducatorPreparationProgramRequest": {
        "type": "object",
        "description": "Create-EducatorPreparationProgram request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that operates the program.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The formal name of the educator preparation program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of educator preparation program."
          },
          "programId": {
            "type": "string",
            "maxLength": 20,
            "description": "A unique code assigned to the program."
          },
          "accreditationStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Accreditation status of the program."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Associated grade levels."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEducatorPreparationProgramRequest": {
        "type": "object",
        "description": "Update-EducatorPreparationProgram request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that operates the program.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The formal name of the educator preparation program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of educator preparation program."
          },
          "programId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 20,
            "description": "A unique code assigned to the program."
          },
          "accreditationStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Accreditation status of the program."
          },
          "gradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Associated grade levels."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEvaluationRequest": {
        "type": "object",
        "description": "Create-Evaluation request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent performance evaluation.",
            "x-references": "performanceEvaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "Evaluation description."
          },
          "minNumericRating": {
            "type": "number",
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": "number",
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "interRaterReliabilityScore": {
            "type": "integer",
            "description": "Inter-rater reliability score."
          },
          "ratingLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEvaluationRequest": {
        "type": "object",
        "description": "Update-Evaluation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent performance evaluation.",
            "x-references": "performanceEvaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Evaluation description."
          },
          "minNumericRating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "interRaterReliabilityScore": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Inter-rater reliability score."
          },
          "ratingLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEvaluationElementRequest": {
        "type": "object",
        "description": "Create-EvaluationElement request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation objective.",
            "x-references": "evaluationObjective.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "sortOrder": {
            "type": "integer",
            "description": "Sort order."
          },
          "minNumericRating": {
            "type": "number",
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": "number",
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "ratingLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEvaluationElementRequest": {
        "type": "object",
        "description": "Update-EvaluationElement request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation objective.",
            "x-references": "evaluationObjective.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "sortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Sort order."
          },
          "minNumericRating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "ratingLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEvaluationElementRatingRequest": {
        "type": "object",
        "description": "Create-EvaluationElementRating request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation objective rating.",
            "x-references": "evaluationObjectiveRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "evaluationElementRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Element rating level."
          },
          "areaOfRefinement": {
            "type": "string",
            "maxLength": 1024,
            "description": "Area of refinement."
          },
          "areaOfReinforcement": {
            "type": "string",
            "maxLength": 1024,
            "description": "Area of reinforcement."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "feedback": {
            "type": "string",
            "maxLength": 2048,
            "description": "Feedback."
          },
          "elementRatingResults": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEvaluationElementRatingRequest": {
        "type": "object",
        "description": "Update-EvaluationElementRating request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation objective rating.",
            "x-references": "evaluationObjectiveRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "evaluationElementRatingLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Element rating level."
          },
          "areaOfRefinement": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Area of refinement."
          },
          "areaOfReinforcement": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Area of reinforcement."
          },
          "comments": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Comments."
          },
          "feedback": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Feedback."
          },
          "elementRatingResults": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEvaluationObjectiveRequest": {
        "type": "object",
        "description": "Create-EvaluationObjective request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationObjectiveTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation.",
            "x-references": "evaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationObjectiveDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "Evaluation objective description."
          },
          "sortOrder": {
            "type": "integer",
            "description": "Sort order."
          },
          "minNumericRating": {
            "type": "number",
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": "number",
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "ratingLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEvaluationObjectiveRequest": {
        "type": "object",
        "description": "Update-EvaluationObjective request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation.",
            "x-references": "evaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationObjectiveDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Evaluation objective description."
          },
          "sortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Sort order."
          },
          "minNumericRating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Minimum numeric rating."
          },
          "maxNumericRating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Maximum numeric rating."
          },
          "evaluationTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Evaluation type."
          },
          "ratingLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEvaluationObjectiveRatingRequest": {
        "type": "object",
        "description": "Create-EvaluationObjectiveRating request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "evaluationObjectiveTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation rating.",
            "x-references": "evaluationRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "objectiveRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Objective rating level."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "objectiveRatingResults": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEvaluationObjectiveRatingRequest": {
        "type": "object",
        "description": "Update-EvaluationObjectiveRating request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation rating.",
            "x-references": "evaluationRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "objectiveRatingLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Objective rating level."
          },
          "comments": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Comments."
          },
          "objectiveRatingResults": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEvaluationRatingRequest": {
        "type": "object",
        "description": "Create-EvaluationRating request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent performance evaluation rating.",
            "x-references": "performanceEvaluationRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Date/time of the evaluation rating."
          },
          "evaluationRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Rating level."
          },
          "evaluationRatingStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Rating status."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "actualDuration": {
            "type": "integer",
            "description": "Actual duration in minutes."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional school of an associated section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Optional section local course code."
          },
          "sectionSchoolYear": {
            "type": "integer",
            "description": "Optional section school year."
          },
          "sectionSessionName": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional section session name."
          },
          "sectionIdentifier": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional section identifier."
          },
          "reviewers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Reviewer middle name."
                },
                "reviewerPersonId": {
                  "type": "string",
                  "maxLength": 32,
                  "description": "Optional personId of the reviewer."
                },
                "reviewerSourceSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Optional source system of the reviewer person."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Reviewers associated with this rating."
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEvaluationRatingRequest": {
        "type": "object",
        "description": "Update-EvaluationRating request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent performance evaluation rating.",
            "x-references": "performanceEvaluationRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Date/time of the evaluation rating."
          },
          "evaluationRatingLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Rating level."
          },
          "evaluationRatingStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Rating status."
          },
          "comments": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Comments."
          },
          "actualDuration": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Actual duration in minutes."
          },
          "schoolSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional school of an associated section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Optional section local course code."
          },
          "sectionSchoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Optional section school year."
          },
          "sectionSessionName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 120,
            "description": "Optional section session name."
          },
          "sectionIdentifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional section identifier."
          },
          "reviewers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Reviewer middle name."
                },
                "reviewerPersonId": {
                  "type": "string",
                  "maxLength": 32,
                  "description": "Optional personId of the reviewer."
                },
                "reviewerSourceSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Optional source system of the reviewer person."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Reviewers associated with this rating."
          },
          "results": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateEvaluationRubricDimensionRequest": {
        "type": "object",
        "description": "Create-EvaluationRubricDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "programEvaluationElementTitle",
          "evaluationRubricRating",
          "evaluationCriterionDescription",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program evaluation element.",
            "x-references": "programEvaluationElement.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor",
              "programEvaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Parent program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent program type."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Parent program evaluation title."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent evaluation period."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent evaluation type."
          },
          "programEvaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Parent program evaluation element title."
          },
          "evaluationRubricRating": {
            "type": "integer",
            "description": "The rubric rating value for this dimension."
          },
          "evaluationCriterionDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Description of the evaluation criterion."
          },
          "evaluationRubricRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Rating level for this rubric dimension."
          },
          "rubricDimensionSortOrder": {
            "type": "integer",
            "description": "Sort order of the rubric dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateEvaluationRubricDimensionRequest": {
        "type": "object",
        "description": "Update-EvaluationRubricDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program evaluation element.",
            "x-references": "programEvaluationElement.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor",
              "programEvaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Parent program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent program type."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Parent program evaluation title."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent evaluation period."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Parent evaluation type."
          },
          "programEvaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Parent program evaluation element title."
          },
          "evaluationRubricRating": {
            "type": "integer",
            "description": "The rubric rating value for this dimension."
          },
          "evaluationCriterionDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Description of the evaluation criterion."
          },
          "evaluationRubricRatingLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Rating level for this rubric dimension."
          },
          "rubricDimensionSortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Sort order of the rubric dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateExportJobRequest": {
        "type": "object",
        "description": "Create-ExportJob request body (readOnly/server-managed fields excluded).",
        "required": [
          "status",
          "startedAt",
          "format",
          "privacyLevel"
        ],
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "in_progress",
              "completed",
              "failed"
            ],
            "description": "Current processing status of the export job."
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when the export job began processing."
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when the export job finished. Null while in progress."
          },
          "format": {
            "type": "string",
            "enum": [
              "json",
              "csv",
              "parquet"
            ],
            "description": "Output format for the exported data."
          },
          "privacyLevel": {
            "type": "string",
            "enum": [
              "full",
              "redacted",
              "anonymized"
            ],
            "description": "Privacy/redaction tier applied to the export. `full` includes all fields, `redacted` strips PII, `anonymized` additionally hashes identifiers."
          }
        }
      },
      "CreateFeederSchoolAssociationRequest": {
        "type": "object",
        "description": "Create-FeederSchoolAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "feederSchoolSourcedId",
          "schoolSourcedId",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "feederSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The feeder school organization. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The receiving school organization. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the feeder relationship became effective."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the feeder relationship ended, if applicable."
          },
          "feederRelationshipDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "A description of the feeder relationship between the schools."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this feeder school association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateFeederSchoolAssociationRequest": {
        "type": "object",
        "description": "Update-FeederSchoolAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "feederSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The feeder school organization. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The receiving school organization. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the feeder relationship became effective."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the feeder relationship ended, if applicable."
          },
          "feederRelationshipDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "A description of the feeder relationship between the schools."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this feeder school association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateFieldworkExperienceRequest": {
        "type": "object",
        "description": "Create-FieldworkExperience request body (readOnly/server-managed fields excluded).",
        "required": [
          "fieldworkIdentifier",
          "studentSourcedId",
          "fieldworkTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "fieldworkIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "A unique identifier for the fieldwork experience."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Fieldwork begin date."
          },
          "fieldworkTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type of fieldwork."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Fieldwork end date."
          },
          "hoursCompleted": {
            "type": "number",
            "description": "Hours completed."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional school.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional EPP education organization.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional EPP program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional EPP program type."
          },
          "coteaching": {
            "type": "object",
            "properties": {
              "coteachingBeginDate": {
                "type": "string",
                "format": "date",
                "description": "Coteaching begin date."
              },
              "coteachingEndDate": {
                "type": "string",
                "format": "date",
                "description": "Coteaching end date."
              }
            },
            "required": [
              "coteachingBeginDate"
            ],
            "description": "Coteaching details."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateFieldworkExperienceRequest": {
        "type": "object",
        "description": "Update-FieldworkExperience request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "fieldworkIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "A unique identifier for the fieldwork experience."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Fieldwork begin date."
          },
          "fieldworkTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type of fieldwork."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Fieldwork end date."
          },
          "hoursCompleted": {
            "type": [
              "number",
              "null"
            ],
            "description": "Hours completed."
          },
          "schoolSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional school.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional EPP education organization.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional EPP program name."
          },
          "programTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Optional EPP program type."
          },
          "coteaching": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "coteachingBeginDate": {
                "type": "string",
                "format": "date",
                "description": "Coteaching begin date."
              },
              "coteachingEndDate": {
                "type": "string",
                "format": "date",
                "description": "Coteaching end date."
              }
            },
            "required": [
              "coteachingBeginDate"
            ],
            "description": "Coteaching details."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateFieldworkExperienceSectionAssociationRequest": {
        "type": "object",
        "description": "Create-FieldworkExperienceSectionAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "fieldworkIdentifier",
          "studentSourcedId",
          "beginDate",
          "schoolSourcedId",
          "localCourseCode",
          "schoolYear",
          "sessionName",
          "sectionIdentifier",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "fieldworkIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Fieldwork experience identifier.",
            "x-references": "fieldworkExperience.fieldworkIdentifier",
            "x-references-legs": [
              "studentSourcedId",
              "beginDate"
            ],
            "x-onDelete": "cascade"
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the fieldwork experience."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Begin date of the fieldwork experience."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Local course code of the section."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year of the section."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Session name of the section."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Section identifier."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateFieldworkExperienceSectionAssociationRequest": {
        "type": "object",
        "description": "Update-FieldworkExperienceSectionAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "fieldworkIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Fieldwork experience identifier.",
            "x-references": "fieldworkExperience.fieldworkIdentifier",
            "x-references-legs": [
              "studentSourcedId",
              "beginDate"
            ],
            "x-onDelete": "cascade"
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the fieldwork experience."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Begin date of the fieldwork experience."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Local course code of the section."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year of the section."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Session name of the section."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Section identifier."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateFinancialAidRequest": {
        "type": "object",
        "description": "Create-FinancialAid request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "beginDate",
          "aidTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student receiving aid.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the award was designated."
          },
          "aidTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The classification of financial aid awarded to a person for the academic term/year."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the award was removed."
          },
          "aidConditionDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "The description of the condition under which the aid was given."
          },
          "aidAmount": {
            "type": "number",
            "description": "The amount of financial aid awarded to a person for the term/year."
          },
          "pellGrantRecipient": {
            "type": "boolean",
            "description": "Indicates a person who receives Pell Grant aid."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateFinancialAidRequest": {
        "type": "object",
        "description": "Update-FinancialAid request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student receiving aid.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the award was designated."
          },
          "aidTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The classification of financial aid awarded to a person for the academic term/year."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the award was removed."
          },
          "aidConditionDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "The description of the condition under which the aid was given."
          },
          "aidAmount": {
            "type": [
              "number",
              "null"
            ],
            "description": "The amount of financial aid awarded to a person for the term/year."
          },
          "pellGrantRecipient": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates a person who receives Pell Grant aid."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateFunctionDimensionRequest": {
        "type": "object",
        "description": "Create-FunctionDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "code",
          "fiscalYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateFunctionDimensionRequest": {
        "type": "object",
        "description": "Update-FunctionDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateFundDimensionRequest": {
        "type": "object",
        "description": "Create-FundDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "code",
          "fiscalYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateFundDimensionRequest": {
        "type": "object",
        "description": "Update-FundDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateGeneralStudentProgramAssociationRequest": {
        "type": "object",
        "description": "Create-GeneralStudentProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student participating in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (e.g., Title I Part A, Special Education, Bilingual/ESL)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program. Typically, this is the date the student becomes eligible for the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateGeneralStudentProgramAssociationRequest": {
        "type": "object",
        "description": "Update-GeneralStudentProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student participating in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (e.g., Title I Part A, Special Education, Bilingual/ESL)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program. Typically, this is the date the student becomes eligible for the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateGeneralStudentProgramAssociationProgramParticipationStatusRequest": {
        "type": "object",
        "description": "Create-GeneralStudentProgramAssociationProgramParticipationStatus request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "participationStatusDescriptor",
          "statusBeginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student sourcedId forming the first column of the composite FK back to the parent generalStudentProgramAssociation.",
            "x-references": "generalStudentProgramAssociation.studentSourcedId",
            "x-references-legs": [
              "programEducationOrganizationSourcedId",
              "programName",
              "programTypeDescriptor",
              "beginDate"
            ],
            "x-onDelete": "cascade"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The program education organization sourcedId forming part of the composite FK back to the parent."
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The program name forming part of the composite FK back to the parent."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The program type descriptor forming part of the composite FK back to the parent."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date forming part of the composite FK back to the parent (the parent's program beginDate)."
          },
          "participationStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The student's program participation status (e.g., Active, Completed, Withdrawn)."
          },
          "statusBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the participation status became effective."
          },
          "statusEndDate": {
            "type": "string",
            "format": "date",
            "description": "The date the participation status ended."
          },
          "designatedBy": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The person, organization, or department that designated the participation status."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateGeneralStudentProgramAssociationProgramParticipationStatusRequest": {
        "type": "object",
        "description": "Update-GeneralStudentProgramAssociationProgramParticipationStatus request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student sourcedId forming the first column of the composite FK back to the parent generalStudentProgramAssociation.",
            "x-references": "generalStudentProgramAssociation.studentSourcedId",
            "x-references-legs": [
              "programEducationOrganizationSourcedId",
              "programName",
              "programTypeDescriptor",
              "beginDate"
            ],
            "x-onDelete": "cascade"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The program education organization sourcedId forming part of the composite FK back to the parent."
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The program name forming part of the composite FK back to the parent."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The program type descriptor forming part of the composite FK back to the parent."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date forming part of the composite FK back to the parent (the parent's program beginDate)."
          },
          "participationStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The student's program participation status (e.g., Active, Completed, Withdrawn)."
          },
          "statusBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the participation status became effective."
          },
          "statusEndDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the participation status ended."
          },
          "designatedBy": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 60,
            "description": "The person, organization, or department that designated the participation status."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateGoalRequest": {
        "type": "object",
        "description": "Create-Goal request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "goalTitle",
          "assignmentDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person the goal is assigned to.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "goalTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Goal title."
          },
          "assignmentDate": {
            "type": "string",
            "format": "date",
            "description": "Date the goal was assigned."
          },
          "goalTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Goal type."
          },
          "goalDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Goal description."
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "description": "Due date."
          },
          "completedIndicator": {
            "type": "boolean",
            "description": "Whether the goal is completed."
          },
          "completedDate": {
            "type": "string",
            "format": "date",
            "description": "Completed date."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional education organization for linked evaluation construct."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "maxLength": 50,
            "description": "Optional performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "Optional school year."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional term."
          },
          "evaluationTitle": {
            "type": "string",
            "maxLength": 50,
            "description": "Optional evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "maxLength": 50,
            "description": "Optional evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional evaluation element title."
          },
          "parentGoalTitle": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional parent goal title (self-ref; command-layer)."
          },
          "parentGoalAssignmentDate": {
            "type": "string",
            "format": "date",
            "description": "Optional parent goal assignment date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateGoalRequest": {
        "type": "object",
        "description": "Update-Goal request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person the goal is assigned to.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "goalTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Goal title."
          },
          "assignmentDate": {
            "type": "string",
            "format": "date",
            "description": "Date the goal was assigned."
          },
          "goalTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Goal type."
          },
          "goalDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Goal description."
          },
          "dueDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Due date."
          },
          "completedIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the goal is completed."
          },
          "completedDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Completed date."
          },
          "comments": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Comments."
          },
          "educationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional education organization for linked evaluation construct."
          },
          "evaluationPeriodDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Optional evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 50,
            "description": "Optional performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Optional performance evaluation type."
          },
          "schoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Optional school year."
          },
          "termDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Optional term."
          },
          "evaluationTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 50,
            "description": "Optional evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 50,
            "description": "Optional evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional evaluation element title."
          },
          "parentGoalTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional parent goal title (self-ref; command-layer)."
          },
          "parentGoalAssignmentDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Optional parent goal assignment date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateGradeRequest": {
        "type": "object",
        "description": "Create-Grade request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "localCourseCode",
          "schoolYear",
          "termDescriptor",
          "sectionIdentifier",
          "gradingPeriodDescriptor",
          "periodSequence",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student receiving the grade.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the grade was earned.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to the section."
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grading period for which the grade is recorded."
          },
          "periodSequence": {
            "type": "integer",
            "description": "The sequential order of this grading period within the school year."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the student's entry or assignment to the section."
          },
          "gradeTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of grade (e.g., Exam, Final, Grading Period)."
          },
          "letterGradeEarned": {
            "type": "string",
            "maxLength": 20,
            "description": "A final or interim letter grade earned for the grading period."
          },
          "numericGradeEarned": {
            "type": "number",
            "description": "A final or interim numeric grade earned."
          },
          "diagnosticStatement": {
            "type": "string",
            "maxLength": 1024,
            "description": "A statement of the grade's diagnostic meaning or context."
          },
          "performanceBaseConversionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Performance base conversion descriptor."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this grade record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateGradeRequest": {
        "type": "object",
        "description": "Update-Grade request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student receiving the grade.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the grade was earned.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to the section."
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grading period for which the grade is recorded."
          },
          "periodSequence": {
            "type": "integer",
            "description": "The sequential order of this grading period within the school year."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the student's entry or assignment to the section."
          },
          "gradeTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of grade (e.g., Exam, Final, Grading Period)."
          },
          "letterGradeEarned": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 20,
            "description": "A final or interim letter grade earned for the grading period."
          },
          "numericGradeEarned": {
            "type": [
              "number",
              "null"
            ],
            "description": "A final or interim numeric grade earned."
          },
          "diagnosticStatement": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "A statement of the grade's diagnostic meaning or context."
          },
          "performanceBaseConversionDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Performance base conversion descriptor."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this grade record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateGradebookEntryRequest": {
        "type": "object",
        "description": "Create-GradebookEntry request body (readOnly/server-managed fields excluded).",
        "required": [
          "gradebookEntryIdentifier",
          "namespace",
          "sourceSectionIdentifier",
          "dateAssigned",
          "title",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "gradebookEntryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to a gradebook entry by the source system."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace URI for the source of the gradebook entry."
          },
          "sourceSectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to a section (source system section id)."
          },
          "dateAssigned": {
            "type": "string",
            "format": "date",
            "description": "The date the assignment was assigned or executed."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name or title of the activity."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "A description of the assignment."
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "description": "The date the assignment is due."
          },
          "dueTime": {
            "type": "string",
            "format": "time",
            "description": "The time the assignment is due."
          },
          "gradebookEntryTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of the gradebook entry."
          },
          "maxPoints": {
            "type": "number",
            "description": "The maximum number of points that can be earned."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional school of the associated section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": "string",
            "maxLength": 60,
            "description": "Optional local course code of the associated section."
          },
          "schoolYear": {
            "type": "integer",
            "description": "Optional school year of the associated section."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional term of the associated section."
          },
          "sectionIdentifier": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional section identifier of the associated section."
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional grading period descriptor."
          },
          "gradingPeriodSequence": {
            "type": "integer",
            "description": "Optional grading period sequence."
          },
          "gradingPeriodSchoolYear": {
            "type": "integer",
            "description": "Optional grading period school year."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Learning standard id."
                }
              },
              "required": [
                "learningStandardId"
              ],
              "description": "learningStandardsItem value."
            },
            "description": "Learning standards associated with the gradebook entry."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateGradebookEntryRequest": {
        "type": "object",
        "description": "Update-GradebookEntry request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "gradebookEntryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to a gradebook entry by the source system."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace URI for the source of the gradebook entry."
          },
          "sourceSectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to a section (source system section id)."
          },
          "dateAssigned": {
            "type": "string",
            "format": "date",
            "description": "The date the assignment was assigned or executed."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name or title of the activity."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "A description of the assignment."
          },
          "dueDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the assignment is due."
          },
          "dueTime": {
            "type": [
              "string",
              "null"
            ],
            "format": "time",
            "description": "The time the assignment is due."
          },
          "gradebookEntryTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of the gradebook entry."
          },
          "maxPoints": {
            "type": [
              "number",
              "null"
            ],
            "description": "The maximum number of points that can be earned."
          },
          "schoolSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional school of the associated section.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "localCourseCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Optional local course code of the associated section."
          },
          "schoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Optional school year of the associated section."
          },
          "termDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Optional term of the associated section."
          },
          "sectionIdentifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional section identifier of the associated section."
          },
          "gradingPeriodDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Optional grading period descriptor."
          },
          "gradingPeriodSequence": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Optional grading period sequence."
          },
          "gradingPeriodSchoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Optional grading period school year."
          },
          "learningStandards": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Learning standard id."
                }
              },
              "required": [
                "learningStandardId"
              ],
              "description": "learningStandardsItem value."
            },
            "description": "Learning standards associated with the gradebook entry."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateGradingPeriodRequest": {
        "type": "object",
        "description": "Create-GradingPeriod request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "gradingPeriodDescriptor",
          "periodSequence",
          "schoolYear",
          "beginDate",
          "endDate"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this grading period belongs to. Establishes the cross-module FK into OneRoster.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of grading period (e.g. First Six Weeks, Second Semester, End of Year). References the GradingPeriodDescriptor governed value."
          },
          "periodSequence": {
            "type": "integer",
            "minimum": 1,
            "description": "The sequential order of this grading period within the school year."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year to which this grading period belongs."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The first calendar date of the grading period."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The last calendar date of the grading period."
          },
          "totalInstructionalDays": {
            "type": "integer",
            "minimum": 0,
            "description": "The total number of instructional days in the grading period."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this grading period record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateGradingPeriodRequest": {
        "type": "object",
        "description": "Update-GradingPeriod request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The first calendar date of the grading period."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The last calendar date of the grading period."
          },
          "totalInstructionalDays": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "The total number of instructional days in the grading period."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this grading period record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateGraduationPlanRequest": {
        "type": "object",
        "description": "Create-GraduationPlan request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "graduationPlanTypeDescriptor",
          "graduationSchoolYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this graduation plan."
          },
          "graduationPlanTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of graduation plan (e.g., Recommended, Distinguished, Minimum)."
          },
          "graduationSchoolYear": {
            "type": "integer",
            "description": "The school year the student is expected to graduate."
          },
          "totalRequiredCredits": {
            "type": "number",
            "description": "The total number of credits required for graduation."
          },
          "totalRequiredCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credits required."
          },
          "individualPlan": {
            "type": "boolean",
            "description": "An indicator of whether the graduation plan is tailored for an individual."
          },
          "requiredCredits": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "creditCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of credit required (e.g., Mathematics, English, Science)."
                },
                "credits": {
                  "type": "number",
                  "description": "The number of credits required in this category."
                },
                "creditTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of credits (e.g., Carnegie unit)."
                }
              },
              "required": [
                "creditCategoryDescriptor",
                "credits"
              ]
            },
            "description": "A credit requirement within a graduation plan, keyed by credit category. Collection child of GraduationPlan. Items unique by (creditCategoryDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this graduation plan record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateGraduationPlanRequest": {
        "type": "object",
        "description": "Update-GraduationPlan request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this graduation plan."
          },
          "graduationPlanTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of graduation plan (e.g., Recommended, Distinguished, Minimum)."
          },
          "graduationSchoolYear": {
            "type": "integer",
            "description": "The school year the student is expected to graduate."
          },
          "totalRequiredCredits": {
            "type": [
              "number",
              "null"
            ],
            "description": "The total number of credits required for graduation."
          },
          "totalRequiredCreditTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of credits required."
          },
          "individualPlan": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indicator of whether the graduation plan is tailored for an individual."
          },
          "requiredCredits": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "creditCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of credit required (e.g., Mathematics, English, Science)."
                },
                "credits": {
                  "type": "number",
                  "description": "The number of credits required in this category."
                },
                "creditTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of credits (e.g., Carnegie unit)."
                }
              },
              "required": [
                "creditCategoryDescriptor",
                "credits"
              ]
            },
            "description": "A credit requirement within a graduation plan, keyed by credit category. Collection child of GraduationPlan. Items unique by (creditCategoryDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this graduation plan record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateIdeaEventRequest": {
        "type": "object",
        "description": "Create-IdeaEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "ideaEventIdentifier",
          "ideaEventTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "ideaEventIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the IDEA event."
          },
          "ideaEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of IDEA event."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the IDEA event."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the IDEA event."
          },
          "eventComplianceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Whether the event was compliant."
          },
          "eventNarrative": {
            "type": "string",
            "maxLength": 2048,
            "description": "Narrative description of the event."
          },
          "eventReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason for the IDEA event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateIdeaEventRequest": {
        "type": "object",
        "description": "Update-IdeaEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "ideaEventIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the IDEA event."
          },
          "ideaEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of IDEA event."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the IDEA event."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The end date of the IDEA event."
          },
          "eventComplianceDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Whether the event was compliant."
          },
          "eventNarrative": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Narrative description of the event."
          },
          "eventReasonDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason for the IDEA event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateImportJobRequest": {
        "type": "object",
        "description": "Create-ImportJob request body (readOnly/server-managed fields excluded).",
        "required": [
          "status",
          "startedAt",
          "totalRows",
          "successCount",
          "failureCount"
        ],
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "in_progress",
              "completed",
              "failed"
            ],
            "description": "Current processing status of the import job."
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when the import job began processing."
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Instant when the import job finished processing. Null while in progress."
          },
          "totalRows": {
            "type": "integer",
            "minimum": 0,
            "description": "Total number of rows submitted in this import batch."
          },
          "successCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of rows that were successfully imported or updated."
          },
          "failureCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of rows that failed validation or import."
          }
        }
      },
      "CreateInterventionRequest": {
        "type": "object",
        "description": "Create-Intervention request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "interventionIdentificationCode",
          "interventionClassDescriptor",
          "deliveryMethodDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The start date for the intervention implementation."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date for the intervention implementation."
          },
          "maxDosage": {
            "type": "integer",
            "description": "The maximum duration of time in minutes that may be assigned for the intervention."
          },
          "minDosage": {
            "type": "integer",
            "description": "The minimum duration of time in minutes that may be assigned for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateInterventionRequest": {
        "type": "object",
        "description": "Update-Intervention request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The start date for the intervention implementation."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The end date for the intervention implementation."
          },
          "maxDosage": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The maximum duration of time in minutes that may be assigned for the intervention."
          },
          "minDosage": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The minimum duration of time in minutes that may be assigned for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateInterventionPrescriptionRequest": {
        "type": "object",
        "description": "Create-InterventionPrescription request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "interventionPrescriptionIdentificationCode",
          "interventionClassDescriptor",
          "deliveryMethodDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this intervention prescription."
          },
          "interventionPrescriptionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention prescription."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "maxDosage": {
            "type": "integer",
            "description": "The maximum duration of time in minutes that may be assigned for the intervention."
          },
          "minDosage": {
            "type": "integer",
            "description": "The minimum duration of time in minutes that may be assigned for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention prescription record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateInterventionPrescriptionRequest": {
        "type": "object",
        "description": "Update-InterventionPrescription request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined this intervention prescription."
          },
          "interventionPrescriptionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention prescription."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "maxDosage": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The maximum duration of time in minutes that may be assigned for the intervention."
          },
          "minDosage": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The minimum duration of time in minutes that may be assigned for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention prescription record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateInterventionStudyRequest": {
        "type": "object",
        "description": "Create-InterventionStudy request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "interventionStudyIdentificationCode",
          "interventionClassDescriptor",
          "deliveryMethodDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that conducted or commissioned this intervention study."
          },
          "interventionStudyIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention study."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "participants": {
            "type": "integer",
            "description": "The number of participants in the intervention study."
          },
          "interventionEffectivenessRatingDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An indicator of the overall effectiveness rating for the intervention study."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention study record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateInterventionStudyRequest": {
        "type": "object",
        "description": "Update-InterventionStudy request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that conducted or commissioned this intervention study."
          },
          "interventionStudyIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention study."
          },
          "interventionClassDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention is used (e.g., supplement, replacement)."
          },
          "deliveryMethodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The way in which an intervention was implemented (e.g., whole class, small group, individual)."
          },
          "participants": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The number of participants in the intervention study."
          },
          "interventionEffectivenessRatingDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "An indicator of the overall effectiveness rating for the intervention study."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this intervention study record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateLearningStandardRequest": {
        "type": "object",
        "description": "Create-LearningStandard request body (readOnly/server-managed fields excluded).",
        "required": [
          "identifier",
          "description",
          "uri",
          "learningStandardId",
          "namespace",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "format": "uuid",
            "description": "The CASE CFItem identifier (composite-natural PK). Required on create; also the Ed-Fi detail-route key under multi-base (joined learningStandardId cannot back a projection derivedHash)."
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "description": "The text of the statement (CASE fullStatement). Shared field — UPDATE requires edfi:write-shared."
          },
          "uri": {
            "type": "string",
            "format": "uri",
            "description": "An unambiguous reference to the statement using a network-resolvable URI (CASE uri). Shared field — UPDATE requires edfi:write-shared."
          },
          "learningStandardItemCode": {
            "type": "string",
            "minLength": 1,
            "description": "A code designated by the promulgating body to identify the statement (CASE humanCodingScheme). Shared field — UPDATE requires edfi:write-shared."
          },
          "learningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a Learning Standard. Ed-Fi-owned extends field; source of the derived-hash GUID."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the organization or entity who governs the standard (e.g., uri://ed-fi.org)."
          },
          "courseTitle": {
            "type": "string",
            "maxLength": 60,
            "description": "The official course title with which this learning standard is associated."
          },
          "successCriteria": {
            "type": "string",
            "maxLength": 150,
            "description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a learning standard."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area (e.g., Mathematics, Science, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject area associated with a learning standard. Items unique by (academicSubjectDescriptor)."
          },
          "contentStandard": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 75,
                "description": "The name of the content standard (e.g., Texas Essential Knowledge and Skills)."
              },
              "uri": {
                "type": "string",
                "maxLength": 255,
                "description": "An unambiguous reference to the standards using a network-resolvable URI."
              },
              "publicationDate": {
                "type": "string",
                "format": "date",
                "description": "The date on which this content was first published."
              },
              "publicationYear": {
                "type": "integer",
                "description": "The year at which this content was first published."
              },
              "version": {
                "type": "string",
                "maxLength": 50,
                "description": "The version identifier for the content."
              },
              "mandatingEducationOrganizationId": {
                "type": "string",
                "maxLength": 255,
                "description": "The identifier of the education organization that mandated this content standard."
              },
              "authors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "author": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "description": "The name of an individual who authored the content standard."
                    }
                  },
                  "required": [
                    "author"
                  ]
                },
                "description": "An author of the content standard associated with a learning standard. Items unique by (author)."
              }
            },
            "description": "Content standard metadata associated with a learning standard (1:1 singleton child)."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which the learning standard is designated (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level associated with a learning standard, indicating the intended audience level. Items unique by (gradeLevelDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to a learning standard by a content standard body."
                },
                "contentStandardName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 65,
                  "description": "The name of the content standard (e.g., Texas Essential Knowledge and Skills, Common Core State Standards)."
                }
              },
              "required": [
                "identificationCode",
                "contentStandardName"
              ]
            },
            "description": "An identification code assigned to a learning standard by a content standard body. Items unique by (identificationCode, contentStandardName)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this learning standard record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateLearningStandardRequest": {
        "type": "object",
        "description": "Update-LearningStandard request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "description": {
            "type": "string",
            "minLength": 1,
            "description": "The text of the statement (CASE fullStatement). Shared field — UPDATE requires edfi:write-shared."
          },
          "uri": {
            "type": "string",
            "format": "uri",
            "description": "An unambiguous reference to the statement using a network-resolvable URI (CASE uri). Shared field — UPDATE requires edfi:write-shared."
          },
          "learningStandardItemCode": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "description": "A code designated by the promulgating body to identify the statement (CASE humanCodingScheme). Shared field — UPDATE requires edfi:write-shared."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The namespace of the organization or entity who governs the standard (e.g., uri://ed-fi.org)."
          },
          "courseTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The official course title with which this learning standard is associated."
          },
          "successCriteria": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 150,
            "description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a learning standard."
          },
          "academicSubjects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject area (e.g., Mathematics, Science, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "An academic subject area associated with a learning standard. Items unique by (academicSubjectDescriptor)."
          },
          "contentStandard": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 75,
                "description": "The name of the content standard (e.g., Texas Essential Knowledge and Skills)."
              },
              "uri": {
                "type": "string",
                "maxLength": 255,
                "description": "An unambiguous reference to the standards using a network-resolvable URI."
              },
              "publicationDate": {
                "type": "string",
                "format": "date",
                "description": "The date on which this content was first published."
              },
              "publicationYear": {
                "type": "integer",
                "description": "The year at which this content was first published."
              },
              "version": {
                "type": "string",
                "maxLength": 50,
                "description": "The version identifier for the content."
              },
              "mandatingEducationOrganizationId": {
                "type": "string",
                "maxLength": 255,
                "description": "The identifier of the education organization that mandated this content standard."
              },
              "authors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "author": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "description": "The name of an individual who authored the content standard."
                    }
                  },
                  "required": [
                    "author"
                  ]
                },
                "description": "An author of the content standard associated with a learning standard. Items unique by (author)."
              }
            },
            "description": "Content standard metadata associated with a learning standard (1:1 singleton child)."
          },
          "gradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which the learning standard is designated (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level associated with a learning standard, indicating the intended audience level. Items unique by (gradeLevelDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to a learning standard by a content standard body."
                },
                "contentStandardName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 65,
                  "description": "The name of the content standard (e.g., Texas Essential Knowledge and Skills, Common Core State Standards)."
                }
              },
              "required": [
                "identificationCode",
                "contentStandardName"
              ]
            },
            "description": "An identification code assigned to a learning standard by a content standard body. Items unique by (identificationCode, contentStandardName)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this learning standard record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateLearningStandardEquivalenceAssociationRequest": {
        "type": "object",
        "description": "Create-LearningStandardEquivalenceAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "sourceLearningStandardId",
          "targetLearningStandardId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "sourceLearningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The source learning standard in the equivalence relationship, matching edfi:learningStandard.learningStandardId. Not a DB-level FK (learningStandard is now a projection of case:cfItem, and its natural key is an extends field, not the master's uuid identifier); validated at the command layer."
          },
          "targetLearningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The target learning standard in the equivalence relationship, matching edfi:learningStandard.learningStandardId. Not a DB-level FK (see sourceLearningStandardId); validated at the command layer."
          },
          "effectiveDate": {
            "type": "string",
            "format": "date",
            "description": "The date from which the equivalence association is effective."
          },
          "equivalenceStrengthDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "A free-text description of the equivalence strength between the source and target standards."
          },
          "equivalenceStrengthDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "A descriptor indicating the strength of the equivalence (e.g., Strong, Moderate, Weak)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateLearningStandardEquivalenceAssociationRequest": {
        "type": "object",
        "description": "Update-LearningStandardEquivalenceAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "sourceLearningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The source learning standard in the equivalence relationship, matching edfi:learningStandard.learningStandardId. Not a DB-level FK (learningStandard is now a projection of case:cfItem, and its natural key is an extends field, not the master's uuid identifier); validated at the command layer."
          },
          "targetLearningStandardId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The target learning standard in the equivalence relationship, matching edfi:learningStandard.learningStandardId. Not a DB-level FK (see sourceLearningStandardId); validated at the command layer."
          },
          "effectiveDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date from which the equivalence association is effective."
          },
          "equivalenceStrengthDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "A free-text description of the equivalence strength between the source and target standards."
          },
          "equivalenceStrengthDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "A descriptor indicating the strength of the equivalence (e.g., Strong, Moderate, Weak)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateLocalAccountRequest": {
        "type": "object",
        "description": "Create-LocalAccount request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "accountClassificationDescriptor",
          "accountCodeNumber",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization (FK to Account).",
            "x-references": "chartOfAccount.educationOrganizationId",
            "x-references-legs": [
              "accountIdentifier",
              "fiscalYear"
            ],
            "x-onDelete": "soft-cascade"
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the parent account (part of parent FK)."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the parent account is valid (part of parent FK)."
          },
          "accountClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of account code classification (e.g., Fund, Function, Object)."
          },
          "accountCodeNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The number assigned to the account code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateLocalAccountRequest": {
        "type": "object",
        "description": "Update-LocalAccount request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization (FK to Account).",
            "x-references": "chartOfAccount.educationOrganizationId",
            "x-references-legs": [
              "accountIdentifier",
              "fiscalYear"
            ],
            "x-onDelete": "soft-cascade"
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the parent account (part of parent FK)."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the parent account is valid (part of parent FK)."
          },
          "accountClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of account code classification (e.g., Fund, Function, Object)."
          },
          "accountCodeNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The number assigned to the account code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateLocalActualRequest": {
        "type": "object",
        "description": "Create-LocalActual request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amount",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the actual is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported actual amount."
          },
          "amount": {
            "type": "number",
            "description": "The current balance or amount for the financial statement dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateLocalActualRequest": {
        "type": "object",
        "description": "Update-LocalActual request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the actual is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported actual amount."
          },
          "amount": {
            "type": "number",
            "description": "The current balance or amount for the financial statement dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateLocalBudgetRequest": {
        "type": "object",
        "description": "Create-LocalBudget request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amount",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the budget is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported budget amount."
          },
          "amount": {
            "type": "number",
            "description": "The budgeted amount for the account."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateLocalBudgetRequest": {
        "type": "object",
        "description": "Update-LocalBudget request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the budget is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported budget amount."
          },
          "amount": {
            "type": "number",
            "description": "The budgeted amount for the account."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateLocalContractedStaffRequest": {
        "type": "object",
        "description": "Create-LocalContractedStaff request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amountToDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the contracted staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the contracted staff expenditure is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported contracted staff amount."
          },
          "amountToDate": {
            "type": "number",
            "description": "The cumulative amount paid to the contracted staff member to date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateLocalContractedStaffRequest": {
        "type": "object",
        "description": "Update-LocalContractedStaff request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the contracted staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the contracted staff expenditure is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported contracted staff amount."
          },
          "amountToDate": {
            "type": "number",
            "description": "The cumulative amount paid to the contracted staff member to date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateLocalEducationAgencyRequest": {
        "type": "object",
        "description": "Create-LocalEducationAgency request body (readOnly/server-managed fields excluded).",
        "required": [
          "localEducationAgencyId",
          "nameOfInstitution",
          "type",
          "localEducationAgencyCategoryDescriptor"
        ],
        "additionalProperties": false,
        "properties": {
          "localEducationAgencyId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies this local education agency in the roster layer. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the local education agency (OneRoster org name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "district"
            ],
            "description": "RESTRICTED to the org type \"district\" — only district-rung org rows are visible through this projection."
          },
          "localEducationAgencyCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of local education agency (e.g. Independent, Charter). References the LocalEducationAgencyCategoryDescriptor governed value."
          },
          "charterStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The charter status of the LEA (e.g. School Charter, Open Enrollment Charter, Not a Charter School). References the CharterStatusDescriptor governed value. NOTE: column is namespaced (leaCharterStatusDescriptor) because oneroster:org is also projected by edfi:school, which owns the plain charterStatusDescriptor column; the wire name is unaffected."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the LEA's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a local education agency. An LEA may have multiple addresses differentiated by address type (e.g. Physical, Mailing). Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this LEA (e.g. School District, Education Service Center). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a local education agency. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a local education agency by an external system (e.g. NCES, state education agency). Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax, Attendance line). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a local education agency, classified by type (e.g. Main, Fax, Attendance). Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this LEA record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateLocalEducationAgencyRequest": {
        "type": "object",
        "description": "Update-LocalEducationAgency request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the local education agency (OneRoster org name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "district"
            ],
            "description": "RESTRICTED to the org type \"district\" — only district-rung org rows are visible through this projection."
          },
          "localEducationAgencyCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of local education agency (e.g. Independent, Charter). References the LocalEducationAgencyCategoryDescriptor governed value."
          },
          "charterStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The charter status of the LEA (e.g. School Charter, Open Enrollment Charter, Not a Charter School). References the CharterStatusDescriptor governed value. NOTE: column is namespaced (leaCharterStatusDescriptor) because oneroster:org is also projected by edfi:school, which owns the plain charterStatusDescriptor column; the wire name is unaffected."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "The URL of the LEA's public website."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a local education agency. An LEA may have multiple addresses differentiated by address type (e.g. Physical, Mailing). Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this LEA (e.g. School District, Education Service Center). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a local education agency. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a local education agency by an external system (e.g. NCES, state education agency). Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax, Attendance line). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a local education agency, classified by type (e.g. Main, Fax, Attendance). Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this LEA record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateLocalEncumbranceRequest": {
        "type": "object",
        "description": "Create-LocalEncumbrance request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amount",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that owns the account."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the encumbrance is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported encumbrance amount."
          },
          "amount": {
            "type": "number",
            "description": "The encumbered amount for the account."
          },
          "financialCollectionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The financial collection associated with this encumbrance."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateLocalEncumbranceRequest": {
        "type": "object",
        "description": "Update-LocalEncumbrance request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that owns the account."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the encumbrance is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported encumbrance amount."
          },
          "amount": {
            "type": "number",
            "description": "The encumbered amount for the account."
          },
          "financialCollectionDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The financial collection associated with this encumbrance."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateLocalPayrollRequest": {
        "type": "object",
        "description": "Create-LocalPayroll request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationId",
          "accountIdentifier",
          "fiscalYear",
          "asOfDate",
          "amount",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member receiving payroll.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the payroll is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported payroll amount."
          },
          "amount": {
            "type": "number",
            "description": "The payroll amount for the staff member."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateLocalPayrollRequest": {
        "type": "object",
        "description": "Update-LocalPayroll request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member receiving payroll.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to an education organization."
          },
          "accountIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The alphanumeric string that identifies the account."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the payroll is recorded."
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the reported payroll amount."
          },
          "amount": {
            "type": "number",
            "description": "The payroll amount for the staff member."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateLocationRequest": {
        "type": "object",
        "description": "Create-Location request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "classroomIdentificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school that owns this location.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classroomIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to a room by the school."
          },
          "maximumNumberOfSeats": {
            "type": "integer",
            "description": "The maximum number of seats the class can maintain."
          },
          "optimalNumberOfSeats": {
            "type": "integer",
            "description": "The most favorable number of seats for the class."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateLocationRequest": {
        "type": "object",
        "description": "Update-Location request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school that owns this location.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classroomIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code assigned to a room by the school."
          },
          "maximumNumberOfSeats": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The maximum number of seats the class can maintain."
          },
          "optimalNumberOfSeats": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The most favorable number of seats for the class."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateObjectDimensionRequest": {
        "type": "object",
        "description": "Create-ObjectDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "code",
          "fiscalYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateObjectDimensionRequest": {
        "type": "object",
        "description": "Update-ObjectDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateObjectiveAssessmentRequest": {
        "type": "object",
        "description": "Create-ObjectiveAssessment request body (readOnly/server-managed fields excluded).",
        "required": [
          "assessmentIdentifier",
          "namespace",
          "identificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this objective belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an objective assessment."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "A detailed description of the objective assessment."
          },
          "maxRawScore": {
            "type": "number",
            "description": "The maximum raw score achievable on this objective assessment."
          },
          "percentOfAssessment": {
            "type": "number",
            "description": "The percentage of the assessment that tests this objective."
          },
          "nomenclature": {
            "type": "string",
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used."
          },
          "parentIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The identification code of the parent objective assessment, for hierarchical objectives."
          },
          "performanceLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level (e.g., Below Basic, Basic, Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this performance level."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score for this performance level."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score for this performance level."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level definition for an objective assessment. Collection child of ObjectiveAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "scores": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this score (e.g., Scale score, Raw score)."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score possible."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score possible."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A score definition for an objective assessment. Collection child of ObjectiveAssessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this objective assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateObjectiveAssessmentRequest": {
        "type": "object",
        "description": "Update-ObjectiveAssessment request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The assessment this objective belongs to.",
            "x-references": "assessment.assessmentIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the parent assessment."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to an objective assessment."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "A detailed description of the objective assessment."
          },
          "maxRawScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "The maximum raw score achievable on this objective assessment."
          },
          "percentOfAssessment": {
            "type": [
              "number",
              "null"
            ],
            "description": "The percentage of the assessment that tests this objective."
          },
          "nomenclature": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "Reflects the specific nomenclature used."
          },
          "parentIdentificationCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The identification code of the parent objective assessment, for hierarchical objectives."
          },
          "performanceLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level (e.g., Below Basic, Basic, Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this performance level."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score for this performance level."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score for this performance level."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level definition for an objective assessment. Collection child of ObjectiveAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "scores": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this score (e.g., Scale score, Raw score)."
                },
                "minimumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The minimum score possible."
                },
                "maximumScore": {
                  "type": "string",
                  "maxLength": 35,
                  "description": "The maximum score possible."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The datatype of the result."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A score definition for an objective assessment. Collection child of ObjectiveAssessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this objective assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateOpenStaffPositionRequest": {
        "type": "object",
        "description": "Create-OpenStaffPosition request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "requisitionNumber",
          "employmentStatusDescriptor",
          "staffClassificationDescriptor",
          "datePosted",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization with the open staff position."
          },
          "requisitionNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "The number or identifier assigned to the open staff position requisition."
          },
          "employmentStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of employment status for the position (e.g., Tenured, Non-tenured, Substitute)."
          },
          "staffClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The staff classification for the position (e.g., Teacher, Principal, Counselor)."
          },
          "datePosted": {
            "type": "string",
            "format": "date",
            "description": "The date the position was posted."
          },
          "datePostingRemoved": {
            "type": "string",
            "format": "date",
            "description": "The date the posting was removed or filled."
          },
          "positionTitle": {
            "type": "string",
            "maxLength": 100,
            "description": "The descriptive title of the position."
          },
          "programAssignmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The program to which the staff position is assigned (e.g., Regular Education, Title I)."
          },
          "postingResultDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The result of the posting (e.g., Position Filled, Position Still Open)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this open staff position record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateOpenStaffPositionRequest": {
        "type": "object",
        "description": "Update-OpenStaffPosition request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization with the open staff position."
          },
          "requisitionNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "The number or identifier assigned to the open staff position requisition."
          },
          "employmentStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of employment status for the position (e.g., Tenured, Non-tenured, Substitute)."
          },
          "staffClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The staff classification for the position (e.g., Teacher, Principal, Counselor)."
          },
          "datePosted": {
            "type": "string",
            "format": "date",
            "description": "The date the position was posted."
          },
          "datePostingRemoved": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the posting was removed or filled."
          },
          "positionTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "The descriptive title of the position."
          },
          "programAssignmentDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The program to which the staff position is assigned (e.g., Regular Education, Title I)."
          },
          "postingResultDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The result of the posting (e.g., Position Filled, Position Still Open)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this open staff position record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateOpenStaffPositionEventRequest": {
        "type": "object",
        "description": "Create-OpenStaffPositionEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "requisitionNumber",
          "eventDate",
          "openStaffPositionEventTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Education organization of the open staff position (openStaffPosition natural-key leg).",
            "x-references": "openStaffPosition.educationOrganizationId",
            "x-references-legs": [
              "requisitionNumber"
            ],
            "x-onDelete": "restrict"
          },
          "requisitionNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Requisition number of the open staff position."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date when the open staff position event occurred."
          },
          "openStaffPositionEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Specifies the type of milestone event."
          },
          "openStaffPositionEventStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Reflects the status of the milestone event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateOpenStaffPositionEventRequest": {
        "type": "object",
        "description": "Update-OpenStaffPositionEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Education organization of the open staff position (openStaffPosition natural-key leg).",
            "x-references": "openStaffPosition.educationOrganizationId",
            "x-references-legs": [
              "requisitionNumber"
            ],
            "x-onDelete": "restrict"
          },
          "requisitionNumber": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20,
            "description": "Requisition number of the open staff position."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date when the open staff position event occurred."
          },
          "openStaffPositionEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Specifies the type of milestone event."
          },
          "openStaffPositionEventStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Reflects the status of the milestone event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateOperationalUnitDimensionRequest": {
        "type": "object",
        "description": "Create-OperationalUnitDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "code",
          "fiscalYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateOperationalUnitDimensionRequest": {
        "type": "object",
        "description": "Update-OperationalUnitDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateOrganizationDepartmentRequest": {
        "type": "object",
        "description": "Create-OrganizationDepartment request body (readOnly/server-managed fields excluded).",
        "required": [
          "organizationDepartmentId",
          "nameOfInstitution",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "organizationDepartmentId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identification code for the organization department."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full, legally accepted name of the department (EducationOrganization inherited)."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 75,
            "description": "A short name for the department."
          },
          "webSite": {
            "type": "string",
            "maxLength": 255,
            "description": "Public website URL."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Operational status."
          },
          "academicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The intended major subject area of the department."
          },
          "parentEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The parent education organization this department belongs to. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Education organization category."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ],
              "description": "categoriesItem value."
            },
            "description": "Category classifications."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of institution telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "institutionTelephonesItem value."
            },
            "description": "Institution telephones."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateOrganizationDepartmentRequest": {
        "type": "object",
        "description": "Update-OrganizationDepartment request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "organizationDepartmentId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identification code for the organization department."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 75,
            "description": "The full, legally accepted name of the department (EducationOrganization inherited)."
          },
          "shortNameOfInstitution": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "A short name for the department."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Public website URL."
          },
          "operationalStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Operational status."
          },
          "academicSubjectDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The intended major subject area of the department."
          },
          "parentEducationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The parent education organization this department belongs to. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Education organization category."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ],
              "description": "categoriesItem value."
            },
            "description": "Category classifications."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of institution telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "institutionTelephonesItem value."
            },
            "description": "Institution telephones."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreatePathRequest": {
        "type": "object",
        "description": "Create-Path request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "pathName",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the path of study. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path of study."
          },
          "graduationPlanEducationOrganizationId": {
            "type": "string",
            "maxLength": 60,
            "description": "Education organization of the optional graduation plan (part of graduationPlan natural key).",
            "x-references": "graduationPlan.educationOrganizationId",
            "x-references-legs": [
              "graduationPlanTypeDescriptor",
              "graduationSchoolYear"
            ],
            "x-onDelete": "restrict"
          },
          "graduationPlanTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Graduation plan type (part of graduationPlan natural key)."
          },
          "graduationSchoolYear": {
            "type": "integer",
            "description": "Graduation school year of the optional graduation plan."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdatePathRequest": {
        "type": "object",
        "description": "Update-Path request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the path of study. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path of study."
          },
          "graduationPlanEducationOrganizationId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Education organization of the optional graduation plan (part of graduationPlan natural key).",
            "x-references": "graduationPlan.educationOrganizationId",
            "x-references-legs": [
              "graduationPlanTypeDescriptor",
              "graduationSchoolYear"
            ],
            "x-onDelete": "restrict"
          },
          "graduationPlanTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Graduation plan type (part of graduationPlan natural key)."
          },
          "graduationSchoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Graduation school year of the optional graduation plan."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreatePathMilestoneRequest": {
        "type": "object",
        "description": "Create-PathMilestone request body (readOnly/server-managed fields excluded).",
        "required": [
          "pathMilestoneName",
          "pathMilestoneTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "pathMilestoneName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path milestone."
          },
          "pathMilestoneTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the path milestone."
          },
          "pathMilestoneCode": {
            "type": "string",
            "maxLength": 60,
            "description": "A code for the path milestone."
          },
          "pathMilestoneDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Description of the path milestone."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdatePathMilestoneRequest": {
        "type": "object",
        "description": "Update-PathMilestone request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "pathMilestoneName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path milestone."
          },
          "pathMilestoneTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the path milestone."
          },
          "pathMilestoneCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "A code for the path milestone."
          },
          "pathMilestoneDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Description of the path milestone."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreatePathPhaseRequest": {
        "type": "object",
        "description": "Create-PathPhase request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "pathName",
          "pathPhaseName",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent path. Roster FK; part of Path natural key.",
            "x-references": "path.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Name of the parent path."
          },
          "pathPhaseName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path phase."
          },
          "pathPhaseSequence": {
            "type": "integer",
            "description": "Sequence order of the phase within the path."
          },
          "phasePathDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Description of the path phase."
          },
          "pathMilestones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "pathMilestoneName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Referenced path milestone name."
                },
                "pathMilestoneTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Referenced path milestone type."
                }
              },
              "required": [
                "pathMilestoneName",
                "pathMilestoneTypeDescriptor"
              ],
              "description": "pathMilestonesItem value."
            },
            "description": "Path milestones associated with this phase (folded join collection)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdatePathPhaseRequest": {
        "type": "object",
        "description": "Update-PathPhase request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent path. Roster FK; part of Path natural key.",
            "x-references": "path.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Name of the parent path."
          },
          "pathPhaseName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the path phase."
          },
          "pathPhaseSequence": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Sequence order of the phase within the path."
          },
          "phasePathDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Description of the path phase."
          },
          "pathMilestones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "pathMilestoneName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Referenced path milestone name."
                },
                "pathMilestoneTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Referenced path milestone type."
                }
              },
              "required": [
                "pathMilestoneName",
                "pathMilestoneTypeDescriptor"
              ],
              "description": "pathMilestonesItem value."
            },
            "description": "Path milestones associated with this phase (folded join collection)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreatePerformanceEvaluationRequest": {
        "type": "object",
        "description": "Create-PerformanceEvaluation request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the performance evaluation.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "performanceEvaluationDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "Description of the performance evaluation."
          },
          "academicSubjectDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Academic subject."
          },
          "ratingLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Associated grade levels."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdatePerformanceEvaluationRequest": {
        "type": "object",
        "description": "Update-PerformanceEvaluation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the performance evaluation.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "performanceEvaluationDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Description of the performance evaluation."
          },
          "academicSubjectDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Academic subject."
          },
          "ratingLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Rating level descriptor."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "Rating levels associated with this evaluation construct."
          },
          "gradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Grade level."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "Associated grade levels."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreatePerformanceEvaluationRatingRequest": {
        "type": "object",
        "description": "Create-PerformanceEvaluationRating request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "actualDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person being evaluated.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the performance evaluation.",
            "x-references": "performanceEvaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "actualDate": {
            "type": "string",
            "format": "date",
            "description": "Actual date of the rating."
          },
          "announced": {
            "type": "boolean",
            "description": "Whether the evaluation was announced."
          },
          "comments": {
            "type": "string",
            "maxLength": 1024,
            "description": "Comments."
          },
          "coteachingStyleObservedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Coteaching style observed."
          },
          "actualDuration": {
            "type": "integer",
            "description": "Actual duration in minutes."
          },
          "performanceEvaluationRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Overall rating level."
          },
          "scheduleDate": {
            "type": "string",
            "format": "date",
            "description": "Scheduled date."
          },
          "actualTime": {
            "type": "string",
            "format": "time",
            "description": "Actual time."
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "reviewers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Reviewer middle name."
                },
                "reviewerPersonId": {
                  "type": "string",
                  "maxLength": 32,
                  "description": "Optional personId of the reviewer."
                },
                "reviewerSourceSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Optional source system of the reviewer person."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Reviewers associated with this rating."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdatePerformanceEvaluationRatingRequest": {
        "type": "object",
        "description": "Update-PerformanceEvaluationRating request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The person being evaluated.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the performance evaluation.",
            "x-references": "performanceEvaluation.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "actualDate": {
            "type": "string",
            "format": "date",
            "description": "Actual date of the rating."
          },
          "announced": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the evaluation was announced."
          },
          "comments": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Comments."
          },
          "coteachingStyleObservedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Coteaching style observed."
          },
          "actualDuration": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Actual duration in minutes."
          },
          "performanceEvaluationRatingLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Overall rating level."
          },
          "scheduleDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Scheduled date."
          },
          "actualTime": {
            "type": [
              "string",
              "null"
            ],
            "format": "time",
            "description": "Actual time."
          },
          "results": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingResultTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the rating result."
                },
                "numericRating": {
                  "type": "number",
                  "description": "Numeric rating value."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Datatype of the result."
                }
              },
              "required": [
                "ratingResultTitle",
                "numericRating",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "Numeric rating results."
          },
          "reviewers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Reviewer last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Reviewer middle name."
                },
                "reviewerPersonId": {
                  "type": "string",
                  "maxLength": 32,
                  "description": "Optional personId of the reviewer."
                },
                "reviewerSourceSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Optional source system of the reviewer person."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Reviewers associated with this rating."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreatePersonRequest": {
        "type": "object",
        "description": "Create-Person request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a person."
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The originating record source system for the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdatePersonRequest": {
        "type": "object",
        "description": "Update-Person request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a person."
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The originating record source system for the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreatePostSecondaryEventRequest": {
        "type": "object",
        "description": "Create-PostSecondaryEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "postSecondaryEventCategoryDescriptor",
          "eventDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with this post-secondary event. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "postSecondaryEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of post-secondary event (e.g., College Application, College Acceptance, College Enrollment)."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date the post-secondary event occurred."
          },
          "postSecondaryInstitutionId": {
            "type": "string",
            "maxLength": 60,
            "description": "The identifier of the post-secondary institution associated with this event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this post-secondary event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdatePostSecondaryEventRequest": {
        "type": "object",
        "description": "Update-PostSecondaryEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with this post-secondary event. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "postSecondaryEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of post-secondary event (e.g., College Application, College Acceptance, College Enrollment)."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date the post-secondary event occurred."
          },
          "postSecondaryInstitutionId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The identifier of the post-secondary institution associated with this event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this post-secondary event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreatePostSecondaryInstitutionRequest": {
        "type": "object",
        "description": "Create-PostSecondaryInstitution request body (readOnly/server-managed fields excluded).",
        "required": [
          "postSecondaryInstitutionId",
          "nameOfInstitution"
        ],
        "additionalProperties": false,
        "properties": {
          "postSecondaryInstitutionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The unique identifier for this post-secondary institution within the tenant."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the post-secondary institution."
          },
          "postSecondaryInstitutionLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The level of the institution (e.g. Four-year, Two-year, Less Than Two-year). References the PostSecondaryInstitutionLevelDescriptor governed value."
          },
          "administrativeFundingControlDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The administrative funding control classification (e.g. Public, Private Nonprofit, Proprietary). References the AdministrativeFundingControlDescriptor governed value."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the institution's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a post-secondary institution. An institution may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this institution. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a post-secondary institution. An institution may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a post-secondary institution by an external system (e.g. IPEDS, NCES). An institution may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Admissions, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a post-secondary institution, classified by type (e.g. Main, Admissions, Fax). An institution may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this post-secondary institution record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdatePostSecondaryInstitutionRequest": {
        "type": "object",
        "description": "Update-PostSecondaryInstitution request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the post-secondary institution."
          },
          "postSecondaryInstitutionLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The level of the institution (e.g. Four-year, Two-year, Less Than Two-year). References the PostSecondaryInstitutionLevelDescriptor governed value."
          },
          "administrativeFundingControlDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The administrative funding control classification (e.g. Public, Private Nonprofit, Proprietary). References the AdministrativeFundingControlDescriptor governed value."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "The URL of the institution's public website."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a post-secondary institution. An institution may have multiple addresses differentiated by address type. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this institution. References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a post-secondary institution. An institution may belong to multiple categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a post-secondary institution by an external system (e.g. IPEDS, NCES). An institution may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Admissions, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a post-secondary institution, classified by type (e.g. Main, Admissions, Fax). An institution may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this post-secondary institution record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateProfessionalDevelopmentEventRequest": {
        "type": "object",
        "description": "Create-ProfessionalDevelopmentEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "professionalDevelopmentTitle",
          "professionalDevelopmentOfferedByDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the professional development event."
          },
          "professionalDevelopmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Title of the professional development event."
          },
          "professionalDevelopmentOfferedByDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Who offered the professional development."
          },
          "totalHours": {
            "type": "integer",
            "description": "Total hours of the event."
          },
          "required": {
            "type": "boolean",
            "description": "Whether attendance is required."
          },
          "multipleSession": {
            "type": "boolean",
            "description": "Whether the event has multiple sessions."
          },
          "professionalDevelopmentReason": {
            "type": "string",
            "maxLength": 60,
            "description": "Reason for the professional development."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateProfessionalDevelopmentEventRequest": {
        "type": "object",
        "description": "Update-ProfessionalDevelopmentEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the professional development event."
          },
          "professionalDevelopmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Title of the professional development event."
          },
          "professionalDevelopmentOfferedByDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Who offered the professional development."
          },
          "totalHours": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Total hours of the event."
          },
          "required": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether attendance is required."
          },
          "multipleSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the event has multiple sessions."
          },
          "professionalDevelopmentReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Reason for the professional development."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateProfessionalDevelopmentEventAttendanceRequest": {
        "type": "object",
        "description": "Create-ProfessionalDevelopmentEventAttendance request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "namespace",
          "professionalDevelopmentTitle",
          "attendanceDate",
          "attendanceEventCategoryDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who attended.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the professional development event.",
            "x-references": "professionalDevelopmentEvent.namespace",
            "x-references-legs": [
              "professionalDevelopmentTitle"
            ],
            "x-onDelete": "restrict"
          },
          "professionalDevelopmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Title of the professional development event."
          },
          "attendanceDate": {
            "type": "string",
            "format": "date",
            "description": "Date of attendance."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Attendance event category."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "Reason for the attendance event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateProfessionalDevelopmentEventAttendanceRequest": {
        "type": "object",
        "description": "Update-ProfessionalDevelopmentEventAttendance request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who attended.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the professional development event.",
            "x-references": "professionalDevelopmentEvent.namespace",
            "x-references-legs": [
              "professionalDevelopmentTitle"
            ],
            "x-onDelete": "restrict"
          },
          "professionalDevelopmentTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Title of the professional development event."
          },
          "attendanceDate": {
            "type": "string",
            "format": "date",
            "description": "Date of attendance."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Attendance event category."
          },
          "attendanceEventReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Reason for the attendance event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateProgramRequest": {
        "type": "object",
        "description": "Create-Program request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId that owns this program (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (e.g., Title I Part A, Special Education, Bilingual/English as a New Language)."
          },
          "programId": {
            "type": "string",
            "maxLength": 20,
            "description": "A unique number or alphanumeric code assigned to a program by a school, school system, state, or other agency or entity."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "programCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic of the program (e.g., year-round, full-day, half-day)."
                }
              },
              "required": [
                "programCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a program (e.g., year-round, full-day), discriminated by the program characteristic descriptor. Collection child of Program. Items unique by (programCharacteristicDescriptor)."
          },
          "learningStandards": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identifier for the learning standard this program addresses. Cross-fragment FK to the LearningStandard entity. References `learningStandard.learningStandardId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                }
              },
              "required": [
                "learningStandardId"
              ]
            },
            "description": "An association between a program and a learning standard that the program addresses. Collection child of Program with a cross-fragment FK to LearningStandard (resolves at wire-verify time). Items unique by (learningStandardId)."
          },
          "sponsors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "programSponsorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The sponsor of the program (e.g., Federal Government, State Government, Local Agency)."
                }
              },
              "required": [
                "programSponsorDescriptor"
              ]
            },
            "description": "An entity that provides financial support or other backing for a program (e.g., federal government, state government, local agency), discriminated by the program sponsor descriptor. Collection child of Program. Items unique by (programSponsorDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this program record. Programs are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this program is deleted."
          }
        }
      },
      "UpdateProgramRequest": {
        "type": "object",
        "description": "Update-Program request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster organization sourcedId that owns this program (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (e.g., Title I Part A, Special Education, Bilingual/English as a New Language)."
          },
          "programId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 20,
            "description": "A unique number or alphanumeric code assigned to a program by a school, school system, state, or other agency or entity."
          },
          "characteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "programCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic of the program (e.g., year-round, full-day, half-day)."
                }
              },
              "required": [
                "programCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a program (e.g., year-round, full-day), discriminated by the program characteristic descriptor. Collection child of Program. Items unique by (programCharacteristicDescriptor)."
          },
          "learningStandards": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "learningStandardId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identifier for the learning standard this program addresses. Cross-fragment FK to the LearningStandard entity. References `learningStandard.learningStandardId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                }
              },
              "required": [
                "learningStandardId"
              ]
            },
            "description": "An association between a program and a learning standard that the program addresses. Collection child of Program with a cross-fragment FK to LearningStandard (resolves at wire-verify time). Items unique by (learningStandardId)."
          },
          "sponsors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "programSponsorDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The sponsor of the program (e.g., Federal Government, State Government, Local Agency)."
                }
              },
              "required": [
                "programSponsorDescriptor"
              ]
            },
            "description": "An entity that provides financial support or other backing for a program (e.g., federal government, state government, local agency), discriminated by the program sponsor descriptor. Collection child of Program. Items unique by (programSponsorDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this program record. Programs are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this program is deleted."
          }
        }
      },
      "CreateProgramDimensionRequest": {
        "type": "object",
        "description": "Create-ProgramDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "dimensionName",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "dimensionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name of the program dimension (e.g., Academic Achievement, Social-Emotional)."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTag": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "A reporting tag for the program dimension."
                }
              },
              "required": [
                "reportingTag"
              ]
            },
            "description": "A reporting tag associated with a program dimension, used for categorization and filtering of evaluation results. Collection child of ProgramDimension. Items unique by (reportingTag)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateProgramDimensionRequest": {
        "type": "object",
        "description": "Update-ProgramDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "dimensionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name of the program dimension (e.g., Academic Achievement, Social-Emotional)."
          },
          "reportingTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "reportingTag": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "A reporting tag for the program dimension."
                }
              },
              "required": [
                "reportingTag"
              ]
            },
            "description": "A reporting tag associated with a program dimension, used for categorization and filtering of evaluation results. Collection child of ProgramDimension. Items unique by (reportingTag)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateProgramEvaluationRequest": {
        "type": "object",
        "description": "Create-ProgramEvaluation request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the evaluation is conducted (e.g., Annual, Mid-Year)."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program evaluation (e.g., Formative, Summative)."
          },
          "programEvaluationDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "A description of the program evaluation."
          },
          "maxRating": {
            "type": "integer",
            "description": "The maximum summary numerical rating or score for the program evaluation."
          },
          "minRating": {
            "type": "integer",
            "description": "The minimum summary numerical rating or score for the program evaluation."
          },
          "levels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor (e.g., Exceeds Expectations, Meets Expectations)."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation. Collection child of ProgramEvaluation. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateProgramEvaluationRequest": {
        "type": "object",
        "description": "Update-ProgramEvaluation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the evaluation is conducted (e.g., Annual, Mid-Year)."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program evaluation (e.g., Formative, Summative)."
          },
          "programEvaluationDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "A description of the program evaluation."
          },
          "maxRating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The maximum summary numerical rating or score for the program evaluation."
          },
          "minRating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The minimum summary numerical rating or score for the program evaluation."
          },
          "levels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor (e.g., Exceeds Expectations, Meets Expectations)."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation. Collection child of ProgramEvaluation. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateProgramEvaluationElementRequest": {
        "type": "object",
        "description": "Create-ProgramEvaluationElement request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "programEvaluationElementTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program evaluation.",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the parent evaluation is conducted."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program evaluation."
          },
          "programEvaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the evaluation element."
          },
          "programEvaluationElementDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "A description of the program evaluation element."
          },
          "maxRating": {
            "type": "integer",
            "description": "The maximum rating for this evaluation element."
          },
          "minRating": {
            "type": "integer",
            "description": "The minimum rating for this evaluation element."
          },
          "programEvaluationLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor for this evaluation element level."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation element. Collection child of ProgramEvaluationElement. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateProgramEvaluationElementRequest": {
        "type": "object",
        "description": "Update-ProgramEvaluationElement request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program evaluation.",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the parent evaluation is conducted."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program evaluation."
          },
          "programEvaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the evaluation element."
          },
          "programEvaluationElementDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "A description of the program evaluation element."
          },
          "maxRating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The maximum rating for this evaluation element."
          },
          "minRating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The minimum rating for this evaluation element."
          },
          "programEvaluationLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor for this evaluation element level."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation element. Collection child of ProgramEvaluationElement. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateProgramEvaluationObjectiveRequest": {
        "type": "object",
        "description": "Create-ProgramEvaluationObjective request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "programEvaluationObjectiveTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program evaluation.",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the parent evaluation is conducted."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program evaluation."
          },
          "programEvaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the evaluation objective."
          },
          "programEvaluationObjectiveDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "A description of the program evaluation objective."
          },
          "maxRating": {
            "type": "integer",
            "description": "The maximum rating for this evaluation objective."
          },
          "minRating": {
            "type": "integer",
            "description": "The minimum rating for this evaluation objective."
          },
          "programEvaluationLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor for this evaluation objective level."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation objective. Collection child of ProgramEvaluationObjective. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateProgramEvaluationObjectiveRequest": {
        "type": "object",
        "description": "Update-ProgramEvaluationObjective request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the parent program evaluation.",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "cascade"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The period for which the parent evaluation is conducted."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program evaluation."
          },
          "programEvaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "The name or title of the evaluation objective."
          },
          "programEvaluationObjectiveDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "A description of the program evaluation objective."
          },
          "maxRating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The maximum rating for this evaluation objective."
          },
          "minRating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The minimum rating for this evaluation objective."
          },
          "programEvaluationLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ratingLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The rating level descriptor for this evaluation objective level."
                }
              },
              "required": [
                "ratingLevelDescriptor"
              ]
            },
            "description": "A rating level descriptor associated with a program evaluation objective. Collection child of ProgramEvaluationObjective. Items unique by (ratingLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateProjectDimensionRequest": {
        "type": "object",
        "description": "Create-ProjectDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "code",
          "fiscalYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateProjectDimensionRequest": {
        "type": "object",
        "description": "Update-ProjectDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateQuantitativeMeasureRequest": {
        "type": "object",
        "description": "Create-QuantitativeMeasure request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "quantitativeMeasureIdentifier",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation element.",
            "x-references": "evaluationElement.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "quantitativeMeasureIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Quantitative measure identifier."
          },
          "quantitativeMeasureTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Quantitative measure type."
          },
          "quantitativeMeasureDatatypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Quantitative measure datatype."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateQuantitativeMeasureRequest": {
        "type": "object",
        "description": "Update-QuantitativeMeasure request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation element.",
            "x-references": "evaluationElement.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "quantitativeMeasureIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Quantitative measure identifier."
          },
          "quantitativeMeasureTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Quantitative measure type."
          },
          "quantitativeMeasureDatatypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Quantitative measure datatype."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateQuantitativeMeasureScoreRequest": {
        "type": "object",
        "description": "Create-QuantitativeMeasureScore request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "quantitativeMeasureIdentifier",
          "scoreValue",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation element rating.",
            "x-references": "evaluationElementRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "quantitativeMeasureIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Quantitative measure identifier."
          },
          "scoreValue": {
            "type": "number",
            "description": "Score value."
          },
          "standardError": {
            "type": "number",
            "description": "Standard error."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateQuantitativeMeasureScoreRequest": {
        "type": "object",
        "description": "Update-QuantitativeMeasureScore request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation element rating.",
            "x-references": "evaluationElementRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "quantitativeMeasureIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "description": "Quantitative measure identifier."
          },
          "scoreValue": {
            "type": "number",
            "description": "Score value."
          },
          "standardError": {
            "type": [
              "number",
              "null"
            ],
            "description": "Standard error."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateRecruitmentEventRequest": {
        "type": "object",
        "description": "Create-RecruitmentEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "eventTitle",
          "eventDate",
          "recruitmentEventTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization hosting the recruitment event. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title of the recruitment event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the recruitment event."
          },
          "eventDescription": {
            "type": "string",
            "maxLength": 255,
            "description": "Description of the event."
          },
          "recruitmentEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type of recruitment event."
          },
          "eventLocation": {
            "type": "string",
            "maxLength": 255,
            "description": "Location of the event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateRecruitmentEventRequest": {
        "type": "object",
        "description": "Update-RecruitmentEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization hosting the recruitment event. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title of the recruitment event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the recruitment event."
          },
          "eventDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Description of the event."
          },
          "recruitmentEventTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type of recruitment event."
          },
          "eventLocation": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Location of the event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateRecruitmentEventAttendanceRequest": {
        "type": "object",
        "description": "Create-RecruitmentEventAttendance request body (readOnly/server-managed fields excluded).",
        "required": [
          "recruitmentEventAttendeeIdentifier",
          "educationOrganizationSourcedId",
          "eventTitle",
          "eventDate",
          "electronicMailAddress",
          "name",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "recruitmentEventAttendeeIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Identifier for the recruitment event attendee."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent recruitment event.",
            "x-references": "recruitmentEvent.educationOrganizationSourcedId",
            "x-references-legs": [
              "eventTitle",
              "eventDate"
            ],
            "x-onDelete": "restrict"
          },
          "eventTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title of the parent recruitment event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the parent recruitment event."
          },
          "electronicMailAddress": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Attendee email address."
          },
          "name": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal first name."
              },
              "lastSurname": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal last/surname."
              },
              "middleName": {
                "type": "string",
                "maxLength": 75,
                "description": "Middle name."
              },
              "personalTitlePrefix": {
                "type": "string",
                "maxLength": 30,
                "description": "Title prefix (e.g., Mr., Dr.)."
              },
              "generationCodeSuffix": {
                "type": "string",
                "maxLength": 10,
                "description": "Generation suffix (e.g., Jr., III)."
              },
              "maidenName": {
                "type": "string",
                "maxLength": 75,
                "description": "Maiden name."
              },
              "preferredFirstName": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred first name."
              },
              "preferredLastSurname": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred last/surname."
              }
            },
            "required": [
              "firstName",
              "lastSurname"
            ],
            "description": "Full legal name of the person."
          },
          "applied": {
            "type": "boolean",
            "description": "Whether the attendee has applied."
          },
          "met": {
            "type": "boolean",
            "description": "Whether the attendee was met."
          },
          "notes": {
            "type": "string",
            "maxLength": 255,
            "description": "Notes about the attendee."
          },
          "preScreeningRating": {
            "type": "integer",
            "description": "Pre-screening rating."
          },
          "recruitmentEventAttendeeTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Attendee type."
          },
          "referral": {
            "type": "boolean",
            "description": "Referral indicator."
          },
          "referredBy": {
            "type": "string",
            "maxLength": 50,
            "description": "Who referred the attendee."
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Sex."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "Gender identity."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race designations."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "socialMediaNetworkName": {
            "type": "string",
            "maxLength": 50,
            "description": "Social media network name."
          },
          "socialMediaUserName": {
            "type": "string",
            "maxLength": 50,
            "description": "Social media user name."
          },
          "currentPosition": {
            "type": "object",
            "properties": {
              "nameOfInstitution": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Institution name."
              },
              "location": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Location."
              },
              "positionTitle": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "description": "Position title."
              },
              "academicSubjectDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "Academic subject."
              },
              "gradeLevels": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "gradeLevelDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Grade level."
                    }
                  },
                  "required": [
                    "gradeLevelDescriptor"
                  ],
                  "description": "gradeLevelsItem value."
                },
                "description": "Grade levels."
              }
            },
            "required": [
              "nameOfInstitution",
              "location",
              "positionTitle"
            ],
            "description": "Current position of the attendee."
          },
          "recruitmentEventAttendeeQualifications": {
            "type": "object",
            "properties": {
              "eligible": {
                "type": "boolean",
                "description": "Eligible indicator."
              },
              "capacityToServe": {
                "type": "boolean",
                "description": "Capacity to serve."
              },
              "yearsOfServiceCurrentPlacement": {
                "type": "number",
                "description": "Years in current placement."
              },
              "yearsOfServiceTotal": {
                "type": "number",
                "description": "Total years of service."
              }
            },
            "required": [
              "eligible",
              "yearsOfServiceTotal"
            ],
            "description": "Attendee qualifications."
          },
          "touchpoints": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "touchpointContent": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Touchpoint content."
                },
                "touchpointDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Touchpoint date."
                }
              },
              "required": [
                "touchpointContent",
                "touchpointDate"
              ],
              "description": "touchpointsItem value."
            },
            "description": "Touchpoints with the attendee (folded)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateRecruitmentEventAttendanceRequest": {
        "type": "object",
        "description": "Update-RecruitmentEventAttendance request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "recruitmentEventAttendeeIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Identifier for the recruitment event attendee."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent recruitment event.",
            "x-references": "recruitmentEvent.educationOrganizationSourcedId",
            "x-references-legs": [
              "eventTitle",
              "eventDate"
            ],
            "x-onDelete": "restrict"
          },
          "eventTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title of the parent recruitment event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date of the parent recruitment event."
          },
          "electronicMailAddress": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Attendee email address."
          },
          "name": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal first name."
              },
              "lastSurname": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Legal last/surname."
              },
              "middleName": {
                "type": "string",
                "maxLength": 75,
                "description": "Middle name."
              },
              "personalTitlePrefix": {
                "type": "string",
                "maxLength": 30,
                "description": "Title prefix (e.g., Mr., Dr.)."
              },
              "generationCodeSuffix": {
                "type": "string",
                "maxLength": 10,
                "description": "Generation suffix (e.g., Jr., III)."
              },
              "maidenName": {
                "type": "string",
                "maxLength": 75,
                "description": "Maiden name."
              },
              "preferredFirstName": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred first name."
              },
              "preferredLastSurname": {
                "type": "string",
                "maxLength": 75,
                "description": "Preferred last/surname."
              }
            },
            "required": [
              "firstName",
              "lastSurname"
            ],
            "description": "Full legal name of the person."
          },
          "applied": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the attendee has applied."
          },
          "met": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the attendee was met."
          },
          "notes": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Notes about the attendee."
          },
          "preScreeningRating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Pre-screening rating."
          },
          "recruitmentEventAttendeeTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Attendee type."
          },
          "referral": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Referral indicator."
          },
          "referredBy": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 50,
            "description": "Who referred the attendee."
          },
          "sexDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Sex."
          },
          "genderIdentity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Gender identity."
          },
          "hispanicLatinoEthnicity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "races": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race designations."
          },
          "disabilities": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "telephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "Telephone number."
                },
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Telephone number type."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Order of priority."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do-not-publish indicator."
                }
              },
              "required": [
                "telephoneNumber",
                "telephoneNumberTypeDescriptor"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "socialMediaNetworkName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 50,
            "description": "Social media network name."
          },
          "socialMediaUserName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 50,
            "description": "Social media user name."
          },
          "currentPosition": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "nameOfInstitution": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Institution name."
              },
              "location": {
                "type": "string",
                "minLength": 1,
                "maxLength": 75,
                "description": "Location."
              },
              "positionTitle": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "description": "Position title."
              },
              "academicSubjectDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "Academic subject."
              },
              "gradeLevels": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "gradeLevelDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Grade level."
                    }
                  },
                  "required": [
                    "gradeLevelDescriptor"
                  ],
                  "description": "gradeLevelsItem value."
                },
                "description": "Grade levels."
              }
            },
            "required": [
              "nameOfInstitution",
              "location",
              "positionTitle"
            ],
            "description": "Current position of the attendee."
          },
          "recruitmentEventAttendeeQualifications": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "eligible": {
                "type": "boolean",
                "description": "Eligible indicator."
              },
              "capacityToServe": {
                "type": "boolean",
                "description": "Capacity to serve."
              },
              "yearsOfServiceCurrentPlacement": {
                "type": "number",
                "description": "Years in current placement."
              },
              "yearsOfServiceTotal": {
                "type": "number",
                "description": "Total years of service."
              }
            },
            "required": [
              "eligible",
              "yearsOfServiceTotal"
            ],
            "description": "Attendee qualifications."
          },
          "touchpoints": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "touchpointContent": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Touchpoint content."
                },
                "touchpointDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Touchpoint date."
                }
              },
              "required": [
                "touchpointContent",
                "touchpointDate"
              ],
              "description": "touchpointsItem value."
            },
            "description": "Touchpoints with the attendee (folded)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateReportCardRequest": {
        "type": "object",
        "description": "Create-ReportCard request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "gradingPeriodDescriptor",
          "periodSequence",
          "schoolYear",
          "schoolSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student this report card belongs to.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization responsible for the report card."
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grading period for which the report card is issued."
          },
          "periodSequence": {
            "type": "integer",
            "description": "The sequential order of this grading period."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school that issued the report card.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "numberOfDaysAbsent": {
            "type": "number",
            "description": "Number of days absent during the grading period."
          },
          "numberOfDaysInAttendance": {
            "type": "number",
            "description": "Number of days in attendance during the grading period."
          },
          "numberOfDaysTardy": {
            "type": "number",
            "description": "Number of days tardy during the grading period."
          },
          "gpaGivenGradingPeriod": {
            "type": "number",
            "description": "GPA for the given grading period on this report card."
          },
          "gpaCumulative": {
            "type": "number",
            "description": "The cumulative GPA."
          },
          "grades": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of grade (e.g., Exam, Final, Grading Period)."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The local course code for the grade entry."
                },
                "letterGradeEarned": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The letter grade earned."
                },
                "numericGradeEarned": {
                  "type": "number",
                  "description": "The numeric grade earned."
                }
              },
              "required": [
                "gradeTypeDescriptor",
                "localCourseCode"
              ]
            },
            "description": "A grade entry on a report card, linking a specific grade to the report card. Collection child of ReportCard. Items unique by (gradeTypeDescriptor, localCourseCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this report card record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateReportCardRequest": {
        "type": "object",
        "description": "Update-ReportCard request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student this report card belongs to.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization responsible for the report card."
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grading period for which the report card is issued."
          },
          "periodSequence": {
            "type": "integer",
            "description": "The sequential order of this grading period."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school that issued the report card.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "numberOfDaysAbsent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of days absent during the grading period."
          },
          "numberOfDaysInAttendance": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of days in attendance during the grading period."
          },
          "numberOfDaysTardy": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of days tardy during the grading period."
          },
          "gpaGivenGradingPeriod": {
            "type": [
              "number",
              "null"
            ],
            "description": "GPA for the given grading period on this report card."
          },
          "gpaCumulative": {
            "type": [
              "number",
              "null"
            ],
            "description": "The cumulative GPA."
          },
          "grades": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of grade (e.g., Exam, Final, Grading Period)."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The local course code for the grade entry."
                },
                "letterGradeEarned": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The letter grade earned."
                },
                "numericGradeEarned": {
                  "type": "number",
                  "description": "The numeric grade earned."
                }
              },
              "required": [
                "gradeTypeDescriptor",
                "localCourseCode"
              ]
            },
            "description": "A grade entry on a report card, linking a specific grade to the report card. Collection child of ReportCard. Items unique by (gradeTypeDescriptor, localCourseCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this report card record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateRestraintEventRequest": {
        "type": "object",
        "description": "Create-RestraintEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "restraintEventIdentifier",
          "eventDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student involved in the restraint event. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the restraint event occurred. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "restraintEventIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A unique identifier for this restraint event within the student and school context."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the restraint event occurred."
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "restraintEventReasonDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reason for the restraint event (e.g., Imminent Serious Physical Harm to Self, Imminent Serious Physical Harm to Others)."
                }
              },
              "required": [
                "restraintEventReasonDescriptor"
              ]
            },
            "description": "A collection child of restraintEvent that records the reason(s) for a restraint event. References the parent restraint event via composite FK with soft-cascade delete. Items unique by (restraintEventReasonDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this restraint event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateRestraintEventRequest": {
        "type": "object",
        "description": "Update-RestraintEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student involved in the restraint event. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the restraint event occurred. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "restraintEventIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A unique identifier for this restraint event within the student and school context."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the restraint event occurred."
          },
          "reasons": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "restraintEventReasonDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reason for the restraint event (e.g., Imminent Serious Physical Harm to Self, Imminent Serious Physical Harm to Others)."
                }
              },
              "required": [
                "restraintEventReasonDescriptor"
              ]
            },
            "description": "A collection child of restraintEvent that records the reason(s) for a restraint event. References the parent restraint event via composite FK with soft-cascade delete. Items unique by (restraintEventReasonDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this restraint event record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateRubricDimensionRequest": {
        "type": "object",
        "description": "Create-RubricDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "rubricRating",
          "criterionDescription",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation element.",
            "x-references": "evaluationElement.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "rubricRating": {
            "type": "integer",
            "description": "Rubric rating value."
          },
          "criterionDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Criterion description."
          },
          "rubricRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Rubric rating level."
          },
          "dimensionOrder": {
            "type": "integer",
            "description": "Dimension order."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateRubricDimensionRequest": {
        "type": "object",
        "description": "Update-RubricDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent evaluation element.",
            "x-references": "evaluationElement.educationOrganizationSourcedId",
            "x-references-legs": [
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "rubricRating": {
            "type": "integer",
            "description": "Rubric rating value."
          },
          "criterionDescription": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Criterion description."
          },
          "rubricRatingLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Rubric rating level."
          },
          "dimensionOrder": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Dimension order."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSchoolRequest": {
        "type": "object",
        "description": "Create-School request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "nameOfInstitution",
          "type"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies this school in the roster layer. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the school (OneRoster org name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "school"
            ],
            "description": "RESTRICTED to the org type \"school\" — only school-rung org rows are visible through this projection."
          },
          "shortNameOfInstitution": {
            "type": "string",
            "maxLength": 256,
            "description": "An abbreviated or commonly-used name for the school."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the school's public website."
          },
          "operationalStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The operational status of the school (e.g. Active, Inactive, New). References the OperationalStatusDescriptor governed value."
          },
          "schoolTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of school (e.g. Regular, Alternative, Career and Technical Education). References the SchoolTypeDescriptor governed value."
          },
          "charterStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The charter status of the school (e.g. School Charter, Open Enrollment Charter, Not a Charter School). References the CharterStatusDescriptor governed value."
          },
          "titleIPartASchoolDesignationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The Title I Part A designation for the school (e.g. Schoolwide, Targeted Assistance, Not Designated). References the TitleIPartASchoolDesignationDescriptor governed value."
          },
          "magnetSpecialProgramEmphasisSchoolDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of magnet or special program emphasis for the school. References the MagnetSpecialProgramEmphasisSchoolDescriptor governed value."
          },
          "administrativeFundingControlDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The administrative funding control classification (e.g. Public School, Private School). References the AdministrativeFundingControlDescriptor governed value."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a school education organization. A school may have multiple addresses differentiated by address type (e.g. Physical, Mailing). Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this school (e.g. Elementary School, Middle School, High School). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a school education organization. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level offered (e.g. First grade, Ninth grade, Twelfth grade). References the GradeLevelDescriptor governed value."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level offered by a school education organization. Items unique by (gradeLevelDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal, Other Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a school by an external system (e.g. NCES, state education agency). Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax, Attendance line). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a school education organization, classified by type (e.g. Main, Fax, Attendance). Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this school record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSchoolRequest": {
        "type": "object",
        "description": "Update-School request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the school (OneRoster org name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "school"
            ],
            "description": "RESTRICTED to the org type \"school\" — only school-rung org rows are visible through this projection."
          },
          "shortNameOfInstitution": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "An abbreviated or commonly-used name for the school."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "The URL of the school's public website."
          },
          "operationalStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The operational status of the school (e.g. Active, Inactive, New). References the OperationalStatusDescriptor governed value."
          },
          "schoolTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of school (e.g. Regular, Alternative, Career and Technical Education). References the SchoolTypeDescriptor governed value."
          },
          "charterStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The charter status of the school (e.g. School Charter, Open Enrollment Charter, Not a Charter School). References the CharterStatusDescriptor governed value."
          },
          "titleIPartASchoolDesignationDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The Title I Part A designation for the school (e.g. Schoolwide, Targeted Assistance, Not Designated). References the TitleIPartASchoolDesignationDescriptor governed value."
          },
          "magnetSpecialProgramEmphasisSchoolDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of magnet or special program emphasis for the school. References the MagnetSpecialProgramEmphasisSchoolDescriptor governed value."
          },
          "administrativeFundingControlDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The administrative funding control classification (e.g. Public School, Private School). References the AdministrativeFundingControlDescriptor governed value."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a school education organization. A school may have multiple addresses differentiated by address type (e.g. Physical, Mailing). Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this school (e.g. Elementary School, Middle School, High School). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a school education organization. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "gradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level offered (e.g. First grade, Ninth grade, Twelfth grade). References the GradeLevelDescriptor governed value."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level offered by a school education organization. Items unique by (gradeLevelDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. SEA, NCES, Federal, Other Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a school by an external system (e.g. NCES, state education agency). Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax, Attendance line). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a school education organization, classified by type (e.g. Main, Fax, Attendance). Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this school record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSectionRequest": {
        "type": "object",
        "description": "Create-Section request body (readOnly/server-managed fields excluded).",
        "required": [
          "classSourcedId",
          "sectionName",
          "schoolSourcedId",
          "localCourseCode",
          "schoolYear",
          "termDescriptor",
          "sectionIdentifier",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The OneRoster class sourcedId that this section maps to one-for-one. Shared roster field — UPDATE requires edfi:write-shared. Also the 1:1 join key into sectionExtension."
          },
          "sectionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "A locally-defined name for the section (OneRoster class title). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster organization sourcedId identifying the school where this section is offered. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering to which this section belongs."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The identifier for the school year in which the section is offered."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term descriptor for the session in which this section is offered (e.g., Fall Semester, Spring Semester)."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to a section."
          },
          "sequenceOfCourse": {
            "type": "integer",
            "minimum": 1,
            "description": "When a section is part of a sequence of parts for a course, the number of the sequence."
          },
          "officialAttendancePeriod": {
            "type": "boolean",
            "description": "Indicator of whether this section is used for official daily attendance."
          },
          "availableCredits": {
            "type": "object",
            "properties": {
              "credits": {
                "type": "number",
                "description": "The number of credits available."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value awarded for the completion of a course."
          },
          "sectionTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "A descriptor specifying the type of section (e.g., Attendance, Credit)."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which a child receives education and related services (e.g., Classroom, Homebound)."
          },
          "mediumOfInstructionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The media through which teachers provide instruction (e.g., Face-to-face, Virtual)."
          },
          "populationServedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of students the section is offered and tailored to (e.g., Regular Students, Gifted and Talented)."
          },
          "instructionLanguageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The primary language of instruction."
          },
          "characteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sectionCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of section characteristic (e.g., Magnet, Self-Contained, Inclusion)."
                }
              },
              "required": [
                "sectionCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a section (e.g., Magnet, Self-Contained), discriminated by the section characteristic descriptor. Items unique by (sectionCharacteristicDescriptor)."
          },
          "classPeriods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "classPeriodName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The name of the class period during which the section meets."
                }
              },
              "required": [
                "classPeriodName"
              ]
            },
            "description": "An association between a section and one or more class periods during which the section meets. Items unique by (classPeriodName)."
          },
          "courseLevelCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of course level characteristic (e.g., Honors, AP, IB, Dual Credit)."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a section's course level (e.g., Honors, AP, IB), discriminated by the course level characteristic descriptor. Items unique by (courseLevelCharacteristicDescriptor)."
          },
          "offeredGradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which this section is offered (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level for which a section is offered, discriminated by the grade level descriptor. Items unique by (gradeLevelDescriptor)."
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The education organization that owns the referenced program. Validated at the command layer against Program (educationOrganizationId+programName+programTypeDescriptor) — the FK does not survive the jsonb fold."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "The formal name of the program."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Bilingual, Special Education)."
                }
              },
              "required": [
                "educationOrganizationId",
                "programName",
                "programTypeDescriptor"
              ]
            },
            "description": "An association between a section and a program, indicating that the section is part of a particular program. Items unique by (educationOrganizationId, programName, programTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateSectionRequest": {
        "type": "object",
        "description": "Update-Section request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "sectionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "A locally-defined name for the section (OneRoster class title). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster organization sourcedId identifying the school where this section is offered. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "localCourseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering to which this section belongs."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The identifier for the school year in which the section is offered."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term descriptor for the session in which this section is offered (e.g., Fall Semester, Spring Semester)."
          },
          "sectionIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The local identifier assigned to a section."
          },
          "sequenceOfCourse": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "When a section is part of a sequence of parts for a course, the number of the sequence."
          },
          "officialAttendancePeriod": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator of whether this section is used for official daily attendance."
          },
          "availableCredits": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "credits": {
                "type": "number",
                "description": "The number of credits available."
              },
              "creditTypeDescriptor": {
                "type": "string",
                "maxLength": 306,
                "description": "The type of credits or units of value awarded."
              },
              "creditConversion": {
                "type": "number",
                "description": "Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units."
              }
            },
            "description": "The value of credits or units of value awarded for the completion of a course."
          },
          "sectionTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "A descriptor specifying the type of section (e.g., Attendance, Credit)."
          },
          "educationalEnvironmentDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The setting in which a child receives education and related services (e.g., Classroom, Homebound)."
          },
          "mediumOfInstructionDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The media through which teachers provide instruction (e.g., Face-to-face, Virtual)."
          },
          "populationServedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of students the section is offered and tailored to (e.g., Regular Students, Gifted and Talented)."
          },
          "instructionLanguageDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The primary language of instruction."
          },
          "characteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "sectionCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of section characteristic (e.g., Magnet, Self-Contained, Inclusion)."
                }
              },
              "required": [
                "sectionCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a section (e.g., Magnet, Self-Contained), discriminated by the section characteristic descriptor. Items unique by (sectionCharacteristicDescriptor)."
          },
          "classPeriods": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "classPeriodName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The name of the class period during which the section meets."
                }
              },
              "required": [
                "classPeriodName"
              ]
            },
            "description": "An association between a section and one or more class periods during which the section meets. Items unique by (classPeriodName)."
          },
          "courseLevelCharacteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "courseLevelCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of course level characteristic (e.g., Honors, AP, IB, Dual Credit)."
                }
              },
              "required": [
                "courseLevelCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic attributed to a section's course level (e.g., Honors, AP, IB), discriminated by the course level characteristic descriptor. Items unique by (courseLevelCharacteristicDescriptor)."
          },
          "offeredGradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level for which this section is offered (e.g., Ninth grade, Tenth grade)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "A grade level for which a section is offered, discriminated by the grade level descriptor. Items unique by (gradeLevelDescriptor)."
          },
          "programs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The education organization that owns the referenced program. Validated at the command layer against Program (educationOrganizationId+programName+programTypeDescriptor) — the FK does not survive the jsonb fold."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "The formal name of the program."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Bilingual, Special Education)."
                }
              },
              "required": [
                "educationOrganizationId",
                "programName",
                "programTypeDescriptor"
              ]
            },
            "description": "An association between a section and a program, indicating that the section is part of a particular program. Items unique by (educationOrganizationId, programName, programTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateSectionAttendanceTakenEventRequest": {
        "type": "object",
        "description": "Create-SectionAttendanceTakenEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "schoolSourcedId",
          "classSourcedId",
          "calendarCode",
          "eventDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where attendance was taken.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The class (section) for which attendance was taken.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The calendar code indicating the instructional calendar associated with the event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which attendance was taken."
          },
          "sectionIdentifier": {
            "type": "string",
            "maxLength": 255,
            "description": "The local identifier assigned to the section."
          },
          "localCourseCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "staffSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The staff member who took attendance for this section.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSectionAttendanceTakenEventRequest": {
        "type": "object",
        "description": "Update-SectionAttendanceTakenEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where attendance was taken.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The class (section) for which attendance was taken.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The calendar code indicating the instructional calendar associated with the event."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which attendance was taken."
          },
          "sectionIdentifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The local identifier assigned to the section."
          },
          "localCourseCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The school year."
          },
          "termDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "staffSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The staff member who took attendance for this section.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSessionRequest": {
        "type": "object",
        "description": "Create-Session request body (readOnly/server-managed fields excluded).",
        "required": [
          "sessionName",
          "beginDate",
          "endDate",
          "schoolYear",
          "schoolSourcedId",
          "type",
          "termDescriptor"
        ],
        "additionalProperties": false,
        "properties": {
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The descriptive name of the session (e.g. 'Fall Semester', 'Q1'). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The first calendar date of the session. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The last calendar date of the session. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year to which this session belongs. Cast from the OneRoster four-digit school-year string. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this session belongs to. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "term",
              "semester"
            ],
            "description": "RESTRICTED to the session types \"term\" and \"semester\" — only these rows are visible through this projection."
          },
          "totalInstructionalDays": {
            "type": "integer",
            "minimum": 0,
            "description": "The total number of instructional days in the session."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The descriptive name of the session (e.g. 'Fall Semester', 'Q1'). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "gradingPeriods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradingPeriodDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grading period descriptor identifying the type of grading period (e.g. First Six Weeks, Second Semester). References the GradingPeriodDescriptor governed value."
                },
                "periodSequence": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The sequential order of the grading period within the session."
                }
              },
              "required": [
                "gradingPeriodDescriptor",
                "periodSequence"
              ]
            },
            "description": "An association between a session and a grading period, establishing which grading periods fall within a given session. Items unique by (gradingPeriodDescriptor, periodSequence)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this session record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSessionRequest": {
        "type": "object",
        "description": "Update-Session request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The descriptive name of the session (e.g. 'Fall Semester', 'Q1'). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The first calendar date of the session. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The last calendar date of the session. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year to which this session belongs. Cast from the OneRoster four-digit school-year string. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster org sourcedId that identifies the school this session belongs to. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "type": {
            "type": "string",
            "enum": [
              "term",
              "semester"
            ],
            "description": "RESTRICTED to the session types \"term\" and \"semester\" — only these rows are visible through this projection."
          },
          "totalInstructionalDays": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "The total number of instructional days in the session."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The descriptive name of the session (e.g. 'Fall Semester', 'Q1'). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "gradingPeriods": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradingPeriodDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grading period descriptor identifying the type of grading period (e.g. First Six Weeks, Second Semester). References the GradingPeriodDescriptor governed value."
                },
                "periodSequence": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The sequential order of the grading period within the session."
                }
              },
              "required": [
                "gradingPeriodDescriptor",
                "periodSequence"
              ]
            },
            "description": "An association between a session and a grading period, establishing which grading periods fall within a given session. Items unique by (gradingPeriodDescriptor, periodSequence)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this session record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSourceDimensionRequest": {
        "type": "object",
        "description": "Create-SourceDimension request body (readOnly/server-managed fields excluded).",
        "required": [
          "code",
          "fiscalYear",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": "string",
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSourceDimensionRequest": {
        "type": "object",
        "description": "Update-SourceDimension request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "description": "The code representation of the dimension."
          },
          "fiscalYear": {
            "type": "integer",
            "description": "The fiscal year for which the dimension is valid."
          },
          "codeName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 100,
            "description": "A descriptive name for the code."
          },
          "reportingTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "reportingTagDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Reporting tag."
                }
              },
              "required": [
                "reportingTagDescriptor"
              ],
              "description": "reportingTagsItem value."
            },
            "description": "Reporting tags associated with this dimension."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffRequest": {
        "type": "object",
        "description": "Update-Staff request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The staff member's legal first name (OneRoster given name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The staff member's legal last/surname (OneRoster family name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "middleName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "The staff member's middle name, if any. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "staffUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "A unique alphanumeric code assigned to a staff member by the district. Ed-Fi-owned extends field; second component of the derived-hash GUID."
          },
          "generationCodeSuffix": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III). Stored under a staff-prefixed column because edfi:student also extends oneroster:user with a generationCodeSuffix field; exposed on the wire as generationCodeSuffix."
          },
          "maidenName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "The staff member's maiden name, if applicable. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as maidenName."
          },
          "personalTitlePrefix": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the staff member. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as personalTitlePrefix."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the staff member was born. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as birthDate."
          },
          "sexDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The staff member's sex at birth. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as sexDescriptor."
          },
          "hispanicLatinoEthnicity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central and South America, and other Spanish cultures."
          },
          "highestCompletedLevelOfEducationDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The extent of formal instruction an individual has received (e.g., the highest grade in school completed or its equivalent or the highest degree received)."
          },
          "yearsOfPriorProfessionalExperience": {
            "type": [
              "number",
              "null"
            ],
            "description": "The total number of years that an individual has previously held a similar professional position in one or more education institutions."
          },
          "yearsOfPriorTeachingExperience": {
            "type": [
              "number",
              "null"
            ],
            "description": "The total number of years that an individual has previously held a teaching position in one or more education institutions."
          },
          "loginId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The login identifier for the staff member, if applicable."
          },
          "highlyQualifiedTeacher": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication of whether a teacher is classified as highly qualified for his/her assignment according to state definition."
          },
          "citizenshipStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "An indicator of whether or not the person is a U.S. citizen. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as citizenshipStatusDescriptor."
          },
          "oldEthnicityDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Previous definition of ethnicity combining combos of race and ethnicity."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which the address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state or jurisdiction in which the address is located."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of the address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which the address is located."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "streetNumberName",
                "stateAbbreviationDescriptor"
              ]
            },
            "description": "A postal address associated with a staff member, discriminated by address type. Multiple addresses per staff member are supported (home, mailing, physical, etc.). Items unique by (addressTypeDescriptor, city, postalCode, streetNumberName, stateAbbreviationDescriptor)."
          },
          "characteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "staffCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic or trait attributed to the staff member."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or no longer applicable."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "staffCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to the staff member (e.g., Migrant, Homeless, Displaced Homemaker), discriminated by characteristic descriptor. Items unique by (staffCharacteristicDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as characteristics."
          },
          "credentials": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the name of the state that issued the credential."
                },
                "credentialFieldDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The field of certification for the credential (e.g., Mathematics, Early Childhood)."
                },
                "credentialTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the category of credential an individual holds (e.g., Certification, Endorsement)."
                },
                "levelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The grade level(s) certified for the credential."
                },
                "teachingCredentialDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the category of a legal document giving authorization to perform teaching assignment services."
                },
                "issuanceDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which an active credential was issued to an individual."
                },
                "expirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which an active credential held by an individual will expire."
                },
                "teachingCredentialBasisDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "An indication of the pre-determined criteria for granting the teaching credential that an individual holds."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "A credential (license, certificate, endorsement) held by a staff member, discriminated by credential identifier and state of issue. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "electronicMails": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the staff member."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the staff member."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a staff member, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as electronicMails."
          },
          "identificationDocuments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to verify a staff member's identity, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as identificationDocuments."
          },
          "internationalAddresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Home, Mailing, Physical, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a staff member, discriminated by address type. Items unique by (addressTypeDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as internationalAddresses."
          },
          "languageUses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language."
                },
                "languageUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A description of how the language is used (e.g., Home language, Dominant language, Correspondence language)."
                }
              },
              "required": [
                "languageDescriptor",
                "languageUseDescriptor"
              ]
            },
            "description": "A description of how the language is used by the staff member (e.g., spoken, written, correspondence), discriminated by language and use descriptors. Items unique by (languageDescriptor, languageUseDescriptor)."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which ISO 639-3 language the staff member speaks or understands."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "A language spoken or understood by the staff member, discriminated by language descriptor. Items unique by (languageDescriptor)."
          },
          "otherNames": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a staff member (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The staff member's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The staff member's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The staff member's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the staff member is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as otherNames."
          },
          "personalIdentificationDocuments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document presented by a staff member for verification purposes, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as personalIdentificationDocuments."
          },
          "races": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category which most clearly reflects the individual's recognition of their community or with which the individual most identifies."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "A race designation for the staff member as reported to the education organization, allowing multiple race entries per staff member. Items unique by (raceDescriptor)."
          },
          "recognitions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "recognitionTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The nature of recognition given to the staff member for accomplishments in a co-curricular, or extra-curricular activity."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title assigned to the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement attributed to the individual."
                },
                "achievementCategorySystem": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The system that defines the categories of achievement for the individual."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the agent issuing the recognition."
                },
                "issuerOriginURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) from which the recognition was issued."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for competency-based completion of the achievement/award."
                },
                "criteriaURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) for the unique address of a web page describing the competency-based completion criteria."
                },
                "evidenceStatement": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "A statement or reference describing the evidence that the individual met the criteria for attainment of the achievement."
                },
                "imageURL": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "The Uniform Resource Locator (URL) for the unique address of an image representing an award or badge associated with the achievement."
                },
                "recognitionDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the type of academic distinctions earned by or awarded to the individual."
                },
                "recognitionAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition was awarded or earned."
                },
                "recognitionAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date on which the recognition expires."
                }
              },
              "required": [
                "recognitionTypeDescriptor"
              ]
            },
            "description": "A recognition or award given to the staff member, discriminated by recognition type. Items unique by (recognitionTypeDescriptor)."
          },
          "telephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of communication number listed for the staff member (e.g., Home, Mobile, Work)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code, and extension, if applicable."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number associated with a staff member, discriminated by telephone number type. Items unique by (telephoneNumberTypeDescriptor, telephoneNumber)."
          },
          "tribalAffiliations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An American Indian tribe with which the staff member is affiliated."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ]
            },
            "description": "A tribal affiliation held by the staff member, discriminated by tribal affiliation descriptor. Items unique by (tribalAffiliationDescriptor)."
          },
          "visas": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "visaDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An indicator of a non-U.S. citizen's visa type."
                }
              },
              "required": [
                "visaDescriptor"
              ]
            },
            "description": "A visa type held by the staff member, discriminated by visa descriptor. Items unique by (visaDescriptor). Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as visas."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this staff record. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as recordState.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action. Stored under a staff-prefixed column (see staffGenerationCodeSuffix); exposed on the wire as deleteSource."
          }
        }
      },
      "CreateStaffAbsenceEventRequest": {
        "type": "object",
        "description": "Create-StaffAbsenceEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "eventDate",
          "absenceEventCategoryDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with this absence event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date for this leave event."
          },
          "absenceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The code describing the type of absence."
          },
          "absenceEventReason": {
            "type": "string",
            "maxLength": 40,
            "description": "Expanded reason for the staff absence."
          },
          "hoursAbsent": {
            "type": "number",
            "description": "The hours the staff was absent, if not the entire working day."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffAbsenceEventRequest": {
        "type": "object",
        "description": "Update-StaffAbsenceEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with this absence event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "Date for this leave event."
          },
          "absenceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The code describing the type of absence."
          },
          "absenceEventReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 40,
            "description": "Expanded reason for the staff absence."
          },
          "hoursAbsent": {
            "type": [
              "number",
              "null"
            ],
            "description": "The hours the staff was absent, if not the entire working day."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffCohortAssociationRequest": {
        "type": "object",
        "description": "Create-StaffCohortAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationId",
          "cohortIdentifier",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member assigned to the cohort.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined the cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the staff member was assigned to the cohort."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the staff member was removed from the cohort."
          },
          "studentRecordAccess": {
            "type": "boolean",
            "description": "An indication of whether the staff member has access to student records for the cohort."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this staff cohort association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffCohortAssociationRequest": {
        "type": "object",
        "description": "Update-StaffCohortAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member assigned to the cohort.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined the cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the staff member was assigned to the cohort."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the staff member was removed from the cohort."
          },
          "studentRecordAccess": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication of whether the staff member has access to student records for the cohort."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this staff cohort association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffDemographicRequest": {
        "type": "object",
        "description": "Create-StaffDemographic request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The staff member's birth sex."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "Gender identity as last reported."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "citizenship": {
            "type": "object",
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation for the individual."
          },
          "ancestryEthnicOrigins": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ancestryEthnicOriginDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Ancestry ethnic origin."
                }
              },
              "required": [
                "ancestryEthnicOriginDescriptor"
              ],
              "description": "ancestryEthnicOriginsItem value."
            },
            "description": "Ancestry ethnic origins."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race category."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race categories."
          },
          "tribalAffiliations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Tribal affiliation."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ],
              "description": "tribalAffiliationsItem value."
            },
            "description": "Tribal affiliations."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffDemographicRequest": {
        "type": "object",
        "description": "Update-StaffDemographic request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The staff member's birth sex."
          },
          "genderIdentity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Gender identity as last reported."
          },
          "hispanicLatinoEthnicity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "citizenship": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation for the individual."
          },
          "ancestryEthnicOrigins": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ancestryEthnicOriginDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Ancestry ethnic origin."
                }
              },
              "required": [
                "ancestryEthnicOriginDescriptor"
              ],
              "description": "ancestryEthnicOriginsItem value."
            },
            "description": "Ancestry ethnic origins."
          },
          "races": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race category."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race categories."
          },
          "tribalAffiliations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Tribal affiliation."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ],
              "description": "tribalAffiliationsItem value."
            },
            "description": "Tribal affiliations."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffDirectoryRequest": {
        "type": "object",
        "description": "Create-StaffDirectory request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The email address."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Priority order of this number."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffDirectoryRequest": {
        "type": "object",
        "description": "Update-StaffDirectory request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "electronicMails": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The email address."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "internationalAddresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Priority order of this number."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffDisciplineIncidentAssociationRequest": {
        "type": "object",
        "description": "Create-StaffDisciplineIncidentAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "schoolSourcedId",
          "incidentIdentifier",
          "disciplineIncidentParticipationCodes",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with the discipline incident.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the discipline incident (disciplineIncident natural-key leg; oneroster:org sourcedId).",
            "x-references": "disciplineIncident.schoolSourcedId",
            "x-references-legs": [
              "incidentIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "Locally assigned unique identifier of the discipline incident."
          },
          "disciplineIncidentParticipationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disciplineIncidentParticipationCodeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The role or type of participation of the staff in a discipline incident."
                }
              },
              "required": [
                "disciplineIncidentParticipationCodeDescriptor"
              ]
            },
            "description": "Participation roles of the staff in the discipline incident. Required folded descriptor collection. Items unique by (disciplineIncidentParticipationCodeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffDisciplineIncidentAssociationRequest": {
        "type": "object",
        "description": "Update-StaffDisciplineIncidentAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with the discipline incident.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the discipline incident (disciplineIncident natural-key leg; oneroster:org sourcedId).",
            "x-references": "disciplineIncident.schoolSourcedId",
            "x-references-legs": [
              "incidentIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "Locally assigned unique identifier of the discipline incident."
          },
          "disciplineIncidentParticipationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disciplineIncidentParticipationCodeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The role or type of participation of the staff in a discipline incident."
                }
              },
              "required": [
                "disciplineIncidentParticipationCodeDescriptor"
              ]
            },
            "description": "Participation roles of the staff in the discipline incident. Required folded descriptor collection. Items unique by (disciplineIncidentParticipationCodeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffEducationOrganizationAssignmentAssociationRequest": {
        "type": "object",
        "description": "Create-StaffEducationOrganizationAssignmentAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "staffClassificationDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member assigned to this education organization.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization to which the staff member is assigned.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The titles of employment, official status, or rank of education staff. Discriminator in the natural key identifying distinct classification assignments at the same organization."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the start of the staff member's assignment to the education organization under this classification."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the end of the staff member's assignment. NULL means the assignment is still active."
          },
          "positionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The descriptive name of an individual's position."
          },
          "orderOfAssignment": {
            "type": "integer",
            "minimum": 1,
            "description": "Describes whether the assignment is this individual's primary assignment or if the assignment is a secondary assignment."
          },
          "credentialFieldDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The field of certification for the certificate (e.g., Mathematics, Music)."
          },
          "fullTimeEquivalency": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "The ratio between the hours of work expected in a position and the hours of work normally expected in a full-time position in the same setting."
          },
          "employmentEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The sourcedId of the education organization where the staff member is employed while assigned to this education organization."
          },
          "employmentStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Reflects the type of employment or contract associated with the staff member's assignment."
          },
          "employmentHireDate": {
            "type": "string",
            "format": "date",
            "description": "The hire date associated with the staff member's employment at the employing education organization."
          },
          "credentials": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which the credential was issued."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "The credentials held by the staff member that are relevant to the assignment at the education organization. A multi-valued collection child of StaffEducationOrganizationAssignmentAssociation keyed by the parent's natural key plus the credential identifier discriminator. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffEducationOrganizationAssignmentAssociationRequest": {
        "type": "object",
        "description": "Update-StaffEducationOrganizationAssignmentAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member assigned to this education organization.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization to which the staff member is assigned.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffClassificationDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The titles of employment, official status, or rank of education staff. Discriminator in the natural key identifying distinct classification assignments at the same organization."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the start of the staff member's assignment to the education organization under this classification."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Month, day, and year of the end of the staff member's assignment. NULL means the assignment is still active."
          },
          "positionTitle": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 100,
            "description": "The descriptive name of an individual's position."
          },
          "orderOfAssignment": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "Describes whether the assignment is this individual's primary assignment or if the assignment is a secondary assignment."
          },
          "credentialFieldDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The field of certification for the certificate (e.g., Mathematics, Music)."
          },
          "fullTimeEquivalency": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1,
            "description": "The ratio between the hours of work expected in a position and the hours of work normally expected in a full-time position in the same setting."
          },
          "employmentEducationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "description": "The sourcedId of the education organization where the staff member is employed while assigned to this education organization."
          },
          "employmentStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "Reflects the type of employment or contract associated with the staff member's assignment."
          },
          "employmentHireDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The hire date associated with the staff member's employment at the employing education organization."
          },
          "credentials": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which the credential was issued."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "The credentials held by the staff member that are relevant to the assignment at the education organization. A multi-valued collection child of StaffEducationOrganizationAssignmentAssociation keyed by the parent's natural key plus the credential identifier discriminator. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffEducationOrganizationEmploymentAssociationRequest": {
        "type": "object",
        "description": "Create-StaffEducationOrganizationEmploymentAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "employmentStatusDescriptor",
          "hireDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member employed by this education organization.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization employing the staff member.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "employmentStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Reflects the type of employment or contract (e.g., Tenured, Non-Tenured, Substitute, Contractual). Discriminator in the natural key identifying distinct employment relationships at the same organization."
          },
          "hireDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an individual was hired for a position."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the employment association ends. NULL means the employment is still active."
          },
          "department": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The department or suborganization the employee/contractor is associated with in the education organization."
          },
          "hourlyWage": {
            "type": "number",
            "minimum": 0,
            "description": "The hourly wage associated with the employment position being reported."
          },
          "annualWage": {
            "type": "number",
            "minimum": 0,
            "description": "The annual wage associated with the employment position being reported."
          },
          "offerDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the employment offer."
          },
          "separationDate": {
            "type": "string",
            "format": "date",
            "description": "The date the staff member's employment ended or will end (formal separation)."
          },
          "separationReasonDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason for the staff member's separation from the education organization (e.g., Retirement, Resignation, Involuntary)."
          },
          "separationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of separation (e.g., Voluntary, Involuntary, Mutual agreement)."
          },
          "credentialFieldDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The field of certification for the certificate associated with this employment (e.g., Mathematics, Music)."
          },
          "fullTimeEquivalency": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "The ratio between the hours of work expected in a position and the hours of work normally expected in a full-time position in the same setting."
          },
          "credentials": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which the credential was issued."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "The credentials held by the staff member that are relevant to their employment at the education organization. A multi-valued collection child of StaffEducationOrganizationEmploymentAssociation keyed by the parent's natural key plus the credential identifier discriminator. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffEducationOrganizationEmploymentAssociationRequest": {
        "type": "object",
        "description": "Update-StaffEducationOrganizationEmploymentAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member employed by this education organization.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization employing the staff member.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "employmentStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Reflects the type of employment or contract (e.g., Tenured, Non-Tenured, Substitute, Contractual). Discriminator in the natural key identifying distinct employment relationships at the same organization."
          },
          "hireDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an individual was hired for a position."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the employment association ends. NULL means the employment is still active."
          },
          "department": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 60,
            "description": "The department or suborganization the employee/contractor is associated with in the education organization."
          },
          "hourlyWage": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "description": "The hourly wage associated with the employment position being reported."
          },
          "annualWage": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "description": "The annual wage associated with the employment position being reported."
          },
          "offerDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date of the employment offer."
          },
          "separationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the staff member's employment ended or will end (formal separation)."
          },
          "separationReasonDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason for the staff member's separation from the education organization (e.g., Retirement, Resignation, Involuntary)."
          },
          "separationTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of separation (e.g., Voluntary, Involuntary, Mutual agreement)."
          },
          "credentialFieldDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The field of certification for the certificate associated with this employment (e.g., Mathematics, Music)."
          },
          "fullTimeEquivalency": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1,
            "description": "The ratio between the hours of work expected in a position and the hours of work normally expected in a full-time position in the same setting."
          },
          "credentials": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "credentialIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Identifier or serial number assigned to the credential."
                },
                "stateOfIssueStateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which the credential was issued."
                }
              },
              "required": [
                "credentialIdentifier",
                "stateOfIssueStateAbbreviationDescriptor"
              ]
            },
            "description": "The credentials held by the staff member that are relevant to their employment at the education organization. A multi-valued collection child of StaffEducationOrganizationEmploymentAssociation keyed by the parent's natural key plus the credential identifier discriminator. Items unique by (credentialIdentifier, stateOfIssueStateAbbreviationDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffEducatorPreparationProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StaffEducatorPreparationProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the EPP.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "EPP program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "EPP program type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Association begin date."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Association end date."
          },
          "completer": {
            "type": "boolean",
            "description": "Whether the staff member completed the program."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffEducatorPreparationProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StaffEducatorPreparationProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the EPP.",
            "x-references": "educatorPreparationProgram.educationOrganizationSourcedId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "EPP program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "EPP program type."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Association begin date."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Association end date."
          },
          "completer": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the staff member completed the program."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffIdentificationCodeRequest": {
        "type": "object",
        "description": "Create-StaffIdentificationCode request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "staffUniqueId",
          "staffIdentificationSystemDescriptor",
          "identificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member this identification code belongs to (references the oneroster:user record backing edfi:staff).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "cascade"
          },
          "staffUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The district-assigned unique identifier for the staff member, matching edfi:staff.staffUniqueId. Not enforced as a DB-level FK leg (staffUniqueId lives on the projection's extends, not the oneroster:user master); validated at the command layer."
          },
          "staffIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a staff member by a school, school system, state, or other agency or entity."
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The organization code or name assigning the staff identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateStaffIdentificationCodeRequest": {
        "type": "object",
        "description": "Update-StaffIdentificationCode request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff member this identification code belongs to (references the oneroster:user record backing edfi:staff).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "cascade"
          },
          "staffUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "The district-assigned unique identifier for the staff member, matching edfi:staff.staffUniqueId. Not enforced as a DB-level FK leg (staffUniqueId lives on the projection's extends, not the oneroster:user master); validated at the command layer."
          },
          "staffIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a staff member by a school, school system, state, or other agency or entity."
          },
          "assigningOrganizationIdentificationCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The organization code or name assigning the staff identification code."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateStaffLeaveRequest": {
        "type": "object",
        "description": "Create-StaffLeave request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "beginDate",
          "staffLeaveEventCategoryDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with this leave event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the staff leave."
          },
          "staffLeaveEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The code describing the type of leave taken."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the staff leave."
          },
          "reason": {
            "type": "string",
            "maxLength": 40,
            "description": "Expanded reason for the staff leave."
          },
          "substituteAssigned": {
            "type": "boolean",
            "description": "Indicator of whether a substitute was assigned during the period of staff leave."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffLeaveRequest": {
        "type": "object",
        "description": "Update-StaffLeave request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with this leave event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the staff leave."
          },
          "staffLeaveEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The code describing the type of leave taken."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The end date of the staff leave."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 40,
            "description": "Expanded reason for the staff leave."
          },
          "substituteAssigned": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator of whether a substitute was assigned during the period of staff leave."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StaffProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with the program. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program (program natural-key leg; also oneroster:org sourcedId).",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Start date for the association of staff to this program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "End date for the association of staff to this program."
          },
          "studentRecordAccess": {
            "type": "boolean",
            "description": "Indicator of whether the staff has access to the student records of the program."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StaffProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The staff associated with the program. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program (program natural-key leg; also oneroster:org sourcedId).",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the parent program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the parent program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Start date for the association of staff to this program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "End date for the association of staff to this program."
          },
          "studentRecordAccess": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator of whether the staff has access to the student records of the program."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffSchoolAssociationRequest": {
        "type": "object",
        "description": "Create-StaffSchoolAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "schoolSourcedId",
          "programAssignmentDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member providing services to this school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the school where the staff member provides services.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programAssignmentDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The name of the program for which the individual is assigned. Discriminator in the natural key identifying distinct assignments at the same school."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the staff member begins providing services to the school under this program assignment."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the staff member stops providing services to the school under this program assignment. NULL means the assignment is still active."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with this staff school assignment."
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar associated with the staff school association."
          },
          "academicSubjects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject the staff member is eligible to teach (e.g. Mathematics, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "The academic subjects the staff member is eligible to teach at the associated school. A multi-valued collection child of StaffSchoolAssociation keyed by the parent's natural key plus the academic subject descriptor discriminator. Items unique by (academicSubjectDescriptor)."
          },
          "gradeLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level the staff member is eligible to teach (e.g. Ninth grade, Kindergarten)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade levels the staff member is eligible to teach at the associated school. A multi-valued collection child of StaffSchoolAssociation keyed by the parent's natural key plus the grade level descriptor discriminator. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffSchoolAssociationRequest": {
        "type": "object",
        "description": "Update-StaffSchoolAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the staff member providing services to this school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the school where the staff member provides services.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programAssignmentDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The name of the program for which the individual is assigned. Discriminator in the natural key identifying distinct assignments at the same school."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the staff member begins providing services to the school under this program assignment."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the staff member stops providing services to the school under this program assignment. NULL means the assignment is still active."
          },
          "schoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with this staff school assignment."
          },
          "calendarCode": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar associated with the staff school association."
          },
          "academicSubjects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicSubjectDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The academic subject the staff member is eligible to teach (e.g. Mathematics, English Language Arts)."
                }
              },
              "required": [
                "academicSubjectDescriptor"
              ]
            },
            "description": "The academic subjects the staff member is eligible to teach at the associated school. A multi-valued collection child of StaffSchoolAssociation keyed by the parent's natural key plus the academic subject descriptor discriminator. Items unique by (academicSubjectDescriptor)."
          },
          "gradeLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradeLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The grade level the staff member is eligible to teach (e.g. Ninth grade, Kindergarten)."
                }
              },
              "required": [
                "gradeLevelDescriptor"
              ]
            },
            "description": "The grade levels the staff member is eligible to teach at the associated school. A multi-valued collection child of StaffSchoolAssociation keyed by the parent's natural key plus the grade level descriptor discriminator. Items unique by (gradeLevelDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStaffSectionAssociationRequest": {
        "type": "object",
        "description": "Create-StaffSectionAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "staffSourcedId",
          "classSourcedId",
          "schoolSourcedId",
          "beginDate",
          "role",
          "classroomPositionDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the staff member assigned to this section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "classSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the class section to which the staff member is assigned. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the school organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of a teacher's assignment to the section. This date is both a natural key component and the effective-from date. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the last day of a staff member's assignment to the section. NULL means the assignment is still active. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "role": {
            "type": "string",
            "enum": [
              "teacher"
            ],
            "description": "RESTRICTED to the enrollment role \"teacher\" — only teacher enrollment rows are visible through this projection."
          },
          "classroomPositionDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of position the staff member holds in the specific class/section (e.g. Teacher of Record, Assistant Teacher, Support Teacher, Substitute Teacher)."
          },
          "highlyQualifiedTeacher": {
            "type": "boolean",
            "description": "An indication of whether a teacher is classified as highly qualified for his/her assignment according to state definition."
          },
          "teacherStudentDataLinkExclusion": {
            "type": "boolean",
            "description": "Indicates that the entire section is excluded from calculation of value-added or growth attribution calculations used for a particular teacher evaluation. NOTE: column is namespaced (staffTeacherStudentDataLinkExclusion) because oneroster:enrollment is also projected by edfi:studentSectionAssociation, which owns the plain teacherStudentDataLinkExclusion column; the wire name is unaffected."
          },
          "percentageContribution": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Indicates the percentage of the total scheduled course time, academic standards, and/or learning activities delivered in this section by this staff member."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStaffSectionAssociationRequest": {
        "type": "object",
        "description": "Update-StaffSectionAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "staffSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the staff member assigned to this section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "classSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the class section to which the staff member is assigned. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the school organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of a teacher's assignment to the section. This date is both a natural key component and the effective-from date. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Month, day, and year of the last day of a staff member's assignment to the section. NULL means the assignment is still active. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "role": {
            "type": "string",
            "enum": [
              "teacher"
            ],
            "description": "RESTRICTED to the enrollment role \"teacher\" — only teacher enrollment rows are visible through this projection."
          },
          "classroomPositionDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of position the staff member holds in the specific class/section (e.g. Teacher of Record, Assistant Teacher, Support Teacher, Substitute Teacher)."
          },
          "highlyQualifiedTeacher": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication of whether a teacher is classified as highly qualified for his/her assignment according to state definition."
          },
          "teacherStudentDataLinkExclusion": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates that the entire section is excluded from calculation of value-added or growth attribution calculations used for a particular teacher evaluation. NOTE: column is namespaced (staffTeacherStudentDataLinkExclusion) because oneroster:enrollment is also projected by edfi:studentSectionAssociation, which owns the plain teacherStudentDataLinkExclusion column; the wire name is unaffected."
          },
          "percentageContribution": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1,
            "description": "Indicates the percentage of the total scheduled course time, academic standards, and/or learning activities delivered in this section by this staff member."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStateEducationAgencyRequest": {
        "type": "object",
        "description": "Create-StateEducationAgency request body (readOnly/server-managed fields excluded).",
        "required": [
          "stateEducationAgencyId",
          "nameOfInstitution"
        ],
        "additionalProperties": false,
        "properties": {
          "stateEducationAgencyId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The unique identifier for this state education agency within the tenant."
          },
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the state education agency."
          },
          "webSite": {
            "type": "string",
            "maxLength": 512,
            "description": "The URL of the SEA's public website."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a state education agency. An SEA may have multiple addresses differentiated by address type (e.g. Physical, Mailing). The composite natural key includes the address type and core location fields to allow multiple addresses per SEA. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this SEA (e.g. State Education Agency). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a state education agency. An SEA may belong to multiple education organization categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a state education agency by an external system (e.g. NCES, Federal). An SEA may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a state education agency, classified by type (e.g. Main, Fax). An SEA may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this SEA record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStateEducationAgencyRequest": {
        "type": "object",
        "description": "Update-StateEducationAgency request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "nameOfInstitution": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "description": "The full official name of the state education agency."
          },
          "webSite": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "The URL of the SEA's public website."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of address (e.g. Physical, Mailing). References the AddressTypeDescriptor governed value."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "description": "The street number and name of the address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The apartment, room, or suite number of the address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The building or site number of the address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The city name of the address."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The state abbreviation (e.g. TX, CA). References the StateAbbreviationDescriptor governed value."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The postal (ZIP) code of the address."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The congressional district in which the address is located."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "The FIPS county code for the address location."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The latitude coordinate of the address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The longitude coordinate of the address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "The name of the county in which the address is located."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "city",
                "postalCode",
                "stateAbbreviationDescriptor",
                "streetNumberName"
              ]
            },
            "description": "A physical or mailing address associated with a state education agency. An SEA may have multiple addresses differentiated by address type (e.g. Physical, Mailing). The composite natural key includes the address type and core location fields to allow multiple addresses per SEA. Items unique by (addressTypeDescriptor, city, postalCode, stateAbbreviationDescriptor, streetNumberName)."
          },
          "categories": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category assigned to this SEA (e.g. State Education Agency). References the EducationOrganizationCategoryDescriptor governed value."
                }
              },
              "required": [
                "educationOrganizationCategoryDescriptor"
              ]
            },
            "description": "A category classification for a state education agency. An SEA may belong to multiple education organization categories. Each row represents one category assignment. Items unique by (educationOrganizationCategoryDescriptor)."
          },
          "identificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationIdentificationSystemDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The identification system that assigned this code (e.g. NCES, Federal). References the EducationOrganizationIdentificationSystemDescriptor governed value."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "description": "The identification code value assigned by the system."
                }
              },
              "required": [
                "educationOrganizationIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "An identification code assigned to a state education agency by an external system (e.g. NCES, Federal). An SEA may have multiple identification codes from different systems. Items unique by (educationOrganizationIdentificationSystemDescriptor)."
          },
          "institutionTelephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "institutionTelephoneNumberTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of telephone number (e.g. Main, Fax). References the InstitutionTelephoneNumberTypeDescriptor governed value."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "The telephone number value."
                }
              },
              "required": [
                "institutionTelephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "A telephone number for a state education agency, classified by type (e.g. Main, Fax). An SEA may have multiple telephone numbers of different types. Items unique by (institutionTelephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted",
              null
            ],
            "description": "Lifecycle state of this SEA record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentRequest": {
        "type": "object",
        "description": "Update-Student request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "firstName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The student's legal first name (OneRoster given name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "lastSurname": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "The student's legal last/surname (OneRoster family name). Shared roster field — UPDATE requires edfi:write-shared."
          },
          "middleName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "The student's middle name, if any. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "generationCodeSuffix": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 10,
            "description": "An appendage, if any, used to denote an individual's generation in their family (e.g., Jr., Sr., III)."
          },
          "maidenName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 75,
            "description": "The student's maiden name, if applicable."
          },
          "personalTitlePrefix": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "A prefix used to denote the title, degree, position, or seniority of the student."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student was born."
          },
          "birthCity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 30,
            "description": "The city the student was born in."
          },
          "birthStateAbbreviationDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The abbreviation for the name of the state (within the United States) or extra-state jurisdiction in which the student was born."
          },
          "birthInternationalProvince": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 150,
            "description": "For students born outside of the U.S., the Province or jurisdiction in which the student was born."
          },
          "birthCountryDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The country in which the student was born."
          },
          "dateEnteredUS": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "For students born outside of the U.S., the date the student entered the U.S."
          },
          "multipleBirthStatus": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator of whether the student was born with other babies as part of a multiple birth."
          },
          "sexDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The student's birth sex as reported to the education organization."
          },
          "citizenshipStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "An indicator of whether or not the student is a U.S. citizen."
          },
          "characteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic attributed to the student."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was designated."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the characteristic was removed or became inactive."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ]
            },
            "description": "A characteristic or trait attributed to the student (e.g., homeless, migrant, immigrant, displaced homemaker), with optional effective date range. Items unique by (studentCharacteristicDescriptor)."
          },
          "cohortYears": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "cohortYearTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of cohort year (e.g., Ninth grade, Expected graduation)."
                },
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "The school year associated with this cohort designation."
                }
              },
              "required": [
                "cohortYearTypeDescriptor",
                "schoolYear"
              ]
            },
            "description": "A cohort year classification for the student, indicating the school year cohort the student entered or is expected to graduate from. Items unique by (cohortYearTypeDescriptor, schoolYear)."
          },
          "disabilityDesignations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A disability category to which the student belongs."
                },
                "disabilityDesignationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The specific designation (e.g., Section 504 Coverage, IDEA Part B Eligible)."
                }
              },
              "required": [
                "disabilityDescriptor",
                "disabilityDesignationDescriptor"
              ]
            },
            "description": "A disability designation for a student, providing the specific designation associated with a disability descriptor (e.g., IDEA qualification, 504 plan). Items unique by (disabilityDescriptor, disabilityDesignationDescriptor)."
          },
          "educationPlans": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationPlanTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of education plan (e.g., IEP, 504 Plan, Gifted and Talented)."
                }
              },
              "required": [
                "educationPlanTypeDescriptor"
              ]
            },
            "description": "An education plan assigned to the student (e.g., IEP, 504 Plan, Career Pathway). Items unique by (educationPlanTypeDescriptor)."
          },
          "electronicMails": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The type of email address (e.g., Home/Personal, Work, Organization)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address for the student."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for the student."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "An electronic mail (e-mail) address associated with a student, discriminated by type (home, work, organization, etc.). Items unique by (electronicMailTypeDescriptor, electronicMailAddress)."
          },
          "identificationDocuments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity (e.g., Personal, Employment)."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose (e.g., Birth Certificate, Passport, Driver's License)."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "An official document used to verify a student's identity, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "indicators": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "indicatorName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "description": "The name of the indicator or metric."
                },
                "indicator": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The value of the indicator or metric."
                },
                "indicatorGroup": {
                  "type": "string",
                  "maxLength": 200,
                  "description": "The name for a group of indicators."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the indicator was assigned to the student."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the indicator was removed."
                }
              },
              "required": [
                "indicatorName"
              ]
            },
            "description": "A named indicator or metric associated with a student (e.g., at-risk, gifted and talented), with optional effective date range. Items unique by (indicatorName)."
          },
          "internationalAddresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home, Temporary)."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The first line of the address."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The second line of the address."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The third line of the address."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The fourth line of the address."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The name of the country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The first date the address is valid."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The last date the address is valid."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ]
            },
            "description": "An international (non-U.S.) address associated with a student, discriminated by address type. Items unique by (addressTypeDescriptor)."
          },
          "migrantEducationProgramServices": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "migrantEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The migrant education program service provided to the student."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if this is the primary service being provided to the migrant student."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student began receiving this service."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student received this service."
                }
              },
              "required": [
                "migrantEducationProgramServiceDescriptor"
              ]
            },
            "description": "A migrant education program service provided to the student, discriminated by service descriptor. Items unique by (migrantEducationProgramServiceDescriptor)."
          },
          "otherNames": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "otherNameTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The types of alternate names for a student (e.g., Alias, Nickname, Previous Legal Name)."
                },
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The student's first name in this alternate identity."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "The student's middle name in this alternate identity."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "The student's last name/surname in this alternate identity."
                },
                "generationCodeSuffix": {
                  "type": "string",
                  "maxLength": 10,
                  "description": "An appendage, if any, used to denote the individual's generation."
                },
                "personalTitlePrefix": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "A prefix used to denote the title, degree, position, or seniority."
                }
              },
              "required": [
                "otherNameTypeDescriptor",
                "firstName",
                "lastSurname"
              ]
            },
            "description": "An alternative name by which the student is known (nickname, alias, previous legal name), discriminated by name type. Items unique by (otherNameTypeDescriptor)."
          },
          "personalIdentificationDocuments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationDocumentUseDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The primary function of the document used for establishing identity."
                },
                "personalInformationVerificationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of the document relative to its purpose."
                },
                "documentTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the document given by the issuer."
                },
                "documentExpirationDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The day when the document expires, if applicable."
                },
                "issuerDocumentIdentificationCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The unique identifier on the issuer's identification system."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Name of the entity or institution that issued the document."
                },
                "issuerCountryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Country of the issuing entity."
                }
              },
              "required": [
                "identificationDocumentUseDescriptor",
                "personalInformationVerificationDescriptor"
              ]
            },
            "description": "A personal identification document presented by the student for identity verification purposes, discriminated by document use type and verification method. Items unique by (identificationDocumentUseDescriptor, personalInformationVerificationDescriptor)."
          },
          "visas": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "visaDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "An indicator of a non-U.S. citizen's Visa type."
                }
              },
              "required": [
                "visaDescriptor"
              ]
            },
            "description": "A visa type associated with a student, indicating immigration/residency documentation. Items unique by (visaDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentAcademicRecordRequest": {
        "type": "object",
        "description": "Create-StudentAcademicRecord request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "schoolYear",
          "termDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to the education organization."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year for which this academic record applies."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term for the session during the school year (e.g., Fall Semester, Spring Semester)."
          },
          "cumulativeEarnedCredits": {
            "type": "number",
            "description": "The cumulative number of credits an individual earns by completing courses or examinations during or before the term."
          },
          "cumulativeEarnedCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credits or units of value awarded for the completion of a course."
          },
          "cumulativeAttemptedCredits": {
            "type": "number",
            "description": "The cumulative number of credits an individual attempts to earn."
          },
          "cumulativeAttemptedCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credit attempted."
          },
          "cumulativeGradePointsEarned": {
            "type": "number",
            "description": "The cumulative number of grade points an individual earns."
          },
          "cumulativeGradePointAverage": {
            "type": "number",
            "description": "The cumulative grade point average."
          },
          "gradeValueQualifier": {
            "type": "string",
            "maxLength": 80,
            "description": "The scale of equivalents used in determining the grade value."
          },
          "projectedGraduationDate": {
            "type": "string",
            "format": "date",
            "description": "The projected date of graduation."
          },
          "sessionEarnedCredits": {
            "type": "number",
            "description": "Credits earned during this session."
          },
          "sessionEarnedCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credits earned during this session."
          },
          "sessionAttemptedCredits": {
            "type": "number",
            "description": "Credits attempted during this session."
          },
          "sessionAttemptedCreditTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of credits attempted during this session."
          },
          "sessionGradePointsEarned": {
            "type": "number",
            "description": "Grade points earned during this session."
          },
          "sessionGradePointAverage": {
            "type": "number",
            "description": "GPA for this session."
          },
          "contentGradePointAverage": {
            "type": "number",
            "description": "A measure of average performance for courses taken in a specific content area."
          },
          "contentGradePointEarned": {
            "type": "number",
            "description": "Grade points earned in a specific content area."
          },
          "academicHonors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "academicHonorCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of academic honor (e.g., Dean's List, Honor Roll, Valedictorian)."
                },
                "honorDescription": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 80,
                  "description": "A description of the type of academic distinctions earned by or awarded to the individual."
                },
                "honorAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the honor was awarded."
                },
                "honorAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the honor expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title assigned to the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement earned."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for earning the honor."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for the criteria details."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the agent that issued the honor."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuing organization."
                }
              },
              "required": [
                "academicHonorCategoryDescriptor",
                "honorDescription"
              ]
            },
            "description": "An academic honor or distinction earned by a student for a specific academic record period. Collection child of StudentAcademicRecord. Items unique by (academicHonorCategoryDescriptor, honorDescription)."
          },
          "classRanking": {
            "type": "object",
            "properties": {
              "classRank": {
                "type": "integer",
                "description": "The student's class rank within the education organization."
              },
              "totalNumberInClass": {
                "type": "integer",
                "description": "The total number of students in the class."
              },
              "percentageRanking": {
                "type": "number",
                "description": "The student's percentile ranking within the class."
              },
              "classRankingDate": {
                "type": "string",
                "format": "date",
                "description": "Date class ranking was determined."
              }
            },
            "required": [
              "classRank",
              "totalNumberInClass"
            ],
            "description": "A student's class ranking for a specific academic record period. Collection child of StudentAcademicRecord."
          },
          "creditsEarned": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "creditTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of credits (e.g., Carnegie unit, Semester hour)."
                },
                "credits": {
                  "type": "number",
                  "description": "The number of credits earned."
                }
              },
              "required": [
                "creditTypeDescriptor",
                "credits"
              ]
            },
            "description": "Credits earned by a student in a specific academic record period, categorized by credit type. Collection child of StudentAcademicRecord. Items unique by (creditTypeDescriptor)."
          },
          "diplomas": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "diplomaTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of diploma/credential earned (e.g., Regular diploma, Certificate of attendance)."
                },
                "diplomaAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which the student met graduation requirements."
                },
                "diplomaDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "The description of the diploma."
                },
                "diplomaLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The level of the diploma (e.g., honors, distinguished)."
                },
                "diplomaAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date the diploma award expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the achievement earned."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement."
                },
                "achievementCategorySystem": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The system that defines the category of achievement."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for earning the achievement."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for criteria details."
                },
                "evidenceStatement": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "A statement or reference describing the evidence."
                },
                "imageUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for image of the diploma/credential."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the entity that issued the credential."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuer."
                }
              },
              "required": [
                "diplomaTypeDescriptor",
                "diplomaAwardDate"
              ]
            },
            "description": "A diploma or credential awarded to a student. Links to the student via OneRoster roster foreign key. Items unique by (diplomaTypeDescriptor, diplomaAwardDate)."
          },
          "gradePointAverages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "gradePointAverageTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of GPA (e.g., Weighted, Unweighted, Cumulative)."
                },
                "gradePointAverageValue": {
                  "type": "number",
                  "description": "The GPA value."
                },
                "isCumulative": {
                  "type": "boolean",
                  "description": "Indicates whether this GPA is cumulative."
                },
                "maxGradePointAverageValue": {
                  "type": "number",
                  "description": "The maximum GPA value achievable on this scale."
                }
              },
              "required": [
                "gradePointAverageTypeDescriptor",
                "gradePointAverageValue"
              ]
            },
            "description": "A GPA calculation for a student academic record, keyed by GPA type. Collection child of StudentAcademicRecord. Items unique by (gradePointAverageTypeDescriptor)."
          },
          "recognitions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "recognitionTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of recognition awarded (e.g., Athletic, Attendance, Citizenship)."
                },
                "recognitionDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the recognition."
                },
                "recognitionAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition was awarded."
                },
                "recognitionAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for receiving this recognition."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for the criteria."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The organization that issued the recognition."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuer."
                }
              },
              "required": [
                "recognitionTypeDescriptor"
              ]
            },
            "description": "A recognition or award received by a student for a specific academic record period. Collection child of StudentAcademicRecord. Items unique by (recognitionTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this academic record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentAcademicRecordRequest": {
        "type": "object",
        "description": "Update-StudentAcademicRecord request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier assigned to the education organization."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year for which this academic record applies."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The term for the session during the school year (e.g., Fall Semester, Spring Semester)."
          },
          "cumulativeEarnedCredits": {
            "type": [
              "number",
              "null"
            ],
            "description": "The cumulative number of credits an individual earns by completing courses or examinations during or before the term."
          },
          "cumulativeEarnedCreditTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of credits or units of value awarded for the completion of a course."
          },
          "cumulativeAttemptedCredits": {
            "type": [
              "number",
              "null"
            ],
            "description": "The cumulative number of credits an individual attempts to earn."
          },
          "cumulativeAttemptedCreditTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of credit attempted."
          },
          "cumulativeGradePointsEarned": {
            "type": [
              "number",
              "null"
            ],
            "description": "The cumulative number of grade points an individual earns."
          },
          "cumulativeGradePointAverage": {
            "type": [
              "number",
              "null"
            ],
            "description": "The cumulative grade point average."
          },
          "gradeValueQualifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 80,
            "description": "The scale of equivalents used in determining the grade value."
          },
          "projectedGraduationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The projected date of graduation."
          },
          "sessionEarnedCredits": {
            "type": [
              "number",
              "null"
            ],
            "description": "Credits earned during this session."
          },
          "sessionEarnedCreditTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of credits earned during this session."
          },
          "sessionAttemptedCredits": {
            "type": [
              "number",
              "null"
            ],
            "description": "Credits attempted during this session."
          },
          "sessionAttemptedCreditTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of credits attempted during this session."
          },
          "sessionGradePointsEarned": {
            "type": [
              "number",
              "null"
            ],
            "description": "Grade points earned during this session."
          },
          "sessionGradePointAverage": {
            "type": [
              "number",
              "null"
            ],
            "description": "GPA for this session."
          },
          "contentGradePointAverage": {
            "type": [
              "number",
              "null"
            ],
            "description": "A measure of average performance for courses taken in a specific content area."
          },
          "contentGradePointEarned": {
            "type": [
              "number",
              "null"
            ],
            "description": "Grade points earned in a specific content area."
          },
          "academicHonors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "academicHonorCategoryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The category of academic honor (e.g., Dean's List, Honor Roll, Valedictorian)."
                },
                "honorDescription": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 80,
                  "description": "A description of the type of academic distinctions earned by or awarded to the individual."
                },
                "honorAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the honor was awarded."
                },
                "honorAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the honor expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title assigned to the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement earned."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for earning the honor."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for the criteria details."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the agent that issued the honor."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuing organization."
                }
              },
              "required": [
                "academicHonorCategoryDescriptor",
                "honorDescription"
              ]
            },
            "description": "An academic honor or distinction earned by a student for a specific academic record period. Collection child of StudentAcademicRecord. Items unique by (academicHonorCategoryDescriptor, honorDescription)."
          },
          "classRanking": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "classRank": {
                "type": "integer",
                "description": "The student's class rank within the education organization."
              },
              "totalNumberInClass": {
                "type": "integer",
                "description": "The total number of students in the class."
              },
              "percentageRanking": {
                "type": "number",
                "description": "The student's percentile ranking within the class."
              },
              "classRankingDate": {
                "type": "string",
                "format": "date",
                "description": "Date class ranking was determined."
              }
            },
            "required": [
              "classRank",
              "totalNumberInClass"
            ],
            "description": "A student's class ranking for a specific academic record period. Collection child of StudentAcademicRecord."
          },
          "creditsEarned": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "creditTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of credits (e.g., Carnegie unit, Semester hour)."
                },
                "credits": {
                  "type": "number",
                  "description": "The number of credits earned."
                }
              },
              "required": [
                "creditTypeDescriptor",
                "credits"
              ]
            },
            "description": "Credits earned by a student in a specific academic record period, categorized by credit type. Collection child of StudentAcademicRecord. Items unique by (creditTypeDescriptor)."
          },
          "diplomas": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "diplomaTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of diploma/credential earned (e.g., Regular diploma, Certificate of attendance)."
                },
                "diplomaAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The month, day, and year on which the student met graduation requirements."
                },
                "diplomaDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "The description of the diploma."
                },
                "diplomaLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The level of the diploma (e.g., honors, distinguished)."
                },
                "diplomaAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date the diploma award expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the achievement earned."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement."
                },
                "achievementCategorySystem": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The system that defines the category of achievement."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for earning the achievement."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for criteria details."
                },
                "evidenceStatement": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "A statement or reference describing the evidence."
                },
                "imageUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for image of the diploma/credential."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The name of the entity that issued the credential."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuer."
                }
              },
              "required": [
                "diplomaTypeDescriptor",
                "diplomaAwardDate"
              ]
            },
            "description": "A diploma or credential awarded to a student. Links to the student via OneRoster roster foreign key. Items unique by (diplomaTypeDescriptor, diplomaAwardDate)."
          },
          "gradePointAverages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "gradePointAverageTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of GPA (e.g., Weighted, Unweighted, Cumulative)."
                },
                "gradePointAverageValue": {
                  "type": "number",
                  "description": "The GPA value."
                },
                "isCumulative": {
                  "type": "boolean",
                  "description": "Indicates whether this GPA is cumulative."
                },
                "maxGradePointAverageValue": {
                  "type": "number",
                  "description": "The maximum GPA value achievable on this scale."
                }
              },
              "required": [
                "gradePointAverageTypeDescriptor",
                "gradePointAverageValue"
              ]
            },
            "description": "A GPA calculation for a student academic record, keyed by GPA type. Collection child of StudentAcademicRecord. Items unique by (gradePointAverageTypeDescriptor)."
          },
          "recognitions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "recognitionTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of recognition awarded (e.g., Athletic, Attendance, Citizenship)."
                },
                "recognitionDescription": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the recognition."
                },
                "recognitionAwardDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition was awarded."
                },
                "recognitionAwardExpiresDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the recognition expires."
                },
                "achievementTitle": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The title of the achievement."
                },
                "achievementCategoryDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The category of achievement."
                },
                "criteria": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The criteria for receiving this recognition."
                },
                "criteriaUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL for the criteria."
                },
                "issuerName": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "The organization that issued the recognition."
                },
                "issuerOriginUrl": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "URL of the issuer."
                }
              },
              "required": [
                "recognitionTypeDescriptor"
              ]
            },
            "description": "A recognition or award received by a student for a specific academic record period. Collection child of StudentAcademicRecord. Items unique by (recognitionTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this academic record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentAssessmentRequest": {
        "type": "object",
        "description": "Create-StudentAssessment request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who took this assessment (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Identifies the assessment that was administered."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment that was administered."
          },
          "administrationDate": {
            "type": "string",
            "format": "date",
            "description": "The date the assessment was administered to the student."
          },
          "administrationEndDate": {
            "type": "string",
            "format": "date",
            "description": "The date the assessment administration ended, if different from the start."
          },
          "serialNumber": {
            "type": "string",
            "maxLength": 60,
            "description": "The unique number for the assessment form or answer document."
          },
          "administrationLanguageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The language in which the assessment was administered."
          },
          "administrationEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The environment in which the assessment was administered (e.g., classroom, lab)."
          },
          "retestIndicatorDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Indicator of whether the student is retesting."
          },
          "reasonNotTestedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The primary reason student is not tested."
          },
          "whenAssessedGradeLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The grade level of the student when assessed."
          },
          "eventCircumstanceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "An unusual event that occurred during the assessment."
          },
          "eventDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Describes an unusual event that occurred during the assessment."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code of the assessment item."
                },
                "assessmentItemResultDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The result of the student's response (e.g., Correct, Incorrect, Not Attempted)."
                },
                "assessmentResponse": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The student's response to the assessment item."
                },
                "descriptiveFeedback": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Descriptive feedback or comments about the student's response."
                },
                "rawScoreResult": {
                  "type": "number",
                  "description": "The raw score earned on this assessment item."
                },
                "timeAssessed": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The time spent on this assessment item."
                }
              },
              "required": [
                "identificationCode"
              ]
            },
            "description": "A student's response and result for an individual assessment item. Collection child of StudentAssessment, keyed on the student assessment's natural key plus the item identification code. Items unique by (identificationCode)."
          },
          "performanceLevels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level achieved (e.g., Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this performance level."
                },
                "performanceLevelMet": {
                  "type": "boolean",
                  "description": "Indicates whether the student met this performance level."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level achieved by a student on an assessment. Collection child of StudentAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "scoreResults": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this score (e.g., Scale score, Raw score, Percentile)."
                },
                "result": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 35,
                  "description": "The value of the score result."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The datatype of the result (e.g., Integer, Decimal, Level)."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor",
                "result",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "A score result from a student's assessment event, keyed by reporting method. Collection child of StudentAssessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "studentObjectiveAssessments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "objectiveAssessmentIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code of the objective assessment being reported on."
                },
                "performanceLevels": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "performanceLevelDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The performance level achieved."
                      },
                      "assessmentReportingMethodDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The reporting method for this performance level."
                      },
                      "performanceLevelMet": {
                        "type": "boolean",
                        "description": "Indicates whether the performance level was met."
                      }
                    },
                    "required": [
                      "performanceLevelDescriptor",
                      "assessmentReportingMethodDescriptor"
                    ]
                  },
                  "description": "A performance level achieved by a student on an objective assessment. Collection child of StudentAssessmentStudentObjectiveAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
                },
                "scoreResults": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "assessmentReportingMethodDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The reporting method for this score."
                      },
                      "result": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 35,
                        "description": "The value of the score result."
                      },
                      "resultDatatypeTypeDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The datatype of the result."
                      }
                    },
                    "required": [
                      "assessmentReportingMethodDescriptor",
                      "result",
                      "resultDatatypeTypeDescriptor"
                    ]
                  },
                  "description": "A score result for a student's performance on an objective assessment within a student assessment event. Collection child of StudentAssessmentStudentObjectiveAssessment. Items unique by (assessmentReportingMethodDescriptor)."
                }
              },
              "required": [
                "objectiveAssessmentIdentificationCode"
              ]
            },
            "description": "A student's performance on an objective assessment within a student assessment event. Collection child of StudentAssessment, capturing per-objective results. Items unique by (objectiveAssessmentIdentificationCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentAssessmentRequest": {
        "type": "object",
        "description": "Update-StudentAssessment request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who took this assessment (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Identifies the assessment that was administered."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the assessment that was administered."
          },
          "administrationDate": {
            "type": "string",
            "format": "date",
            "description": "The date the assessment was administered to the student."
          },
          "administrationEndDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the assessment administration ended, if different from the start."
          },
          "serialNumber": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The unique number for the assessment form or answer document."
          },
          "administrationLanguageDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The language in which the assessment was administered."
          },
          "administrationEnvironmentDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The environment in which the assessment was administered (e.g., classroom, lab)."
          },
          "retestIndicatorDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Indicator of whether the student is retesting."
          },
          "reasonNotTestedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The primary reason student is not tested."
          },
          "whenAssessedGradeLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The grade level of the student when assessed."
          },
          "eventCircumstanceDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "An unusual event that occurred during the assessment."
          },
          "eventDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Describes an unusual event that occurred during the assessment."
          },
          "items": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code of the assessment item."
                },
                "assessmentItemResultDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The result of the student's response (e.g., Correct, Incorrect, Not Attempted)."
                },
                "assessmentResponse": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The student's response to the assessment item."
                },
                "descriptiveFeedback": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Descriptive feedback or comments about the student's response."
                },
                "rawScoreResult": {
                  "type": "number",
                  "description": "The raw score earned on this assessment item."
                },
                "timeAssessed": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The time spent on this assessment item."
                }
              },
              "required": [
                "identificationCode"
              ]
            },
            "description": "A student's response and result for an individual assessment item. Collection child of StudentAssessment, keyed on the student assessment's natural key plus the item identification code. Items unique by (identificationCode)."
          },
          "performanceLevels": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "performanceLevelDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The performance level achieved (e.g., Proficient, Advanced)."
                },
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this performance level."
                },
                "performanceLevelMet": {
                  "type": "boolean",
                  "description": "Indicates whether the student met this performance level."
                }
              },
              "required": [
                "performanceLevelDescriptor",
                "assessmentReportingMethodDescriptor"
              ]
            },
            "description": "A performance level achieved by a student on an assessment. Collection child of StudentAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
          },
          "scoreResults": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "assessmentReportingMethodDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The reporting method for this score (e.g., Scale score, Raw score, Percentile)."
                },
                "result": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 35,
                  "description": "The value of the score result."
                },
                "resultDatatypeTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The datatype of the result (e.g., Integer, Decimal, Level)."
                }
              },
              "required": [
                "assessmentReportingMethodDescriptor",
                "result",
                "resultDatatypeTypeDescriptor"
              ]
            },
            "description": "A score result from a student's assessment event, keyed by reporting method. Collection child of StudentAssessment. Items unique by (assessmentReportingMethodDescriptor)."
          },
          "studentObjectiveAssessments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "objectiveAssessmentIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identification code of the objective assessment being reported on."
                },
                "performanceLevels": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "performanceLevelDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The performance level achieved."
                      },
                      "assessmentReportingMethodDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The reporting method for this performance level."
                      },
                      "performanceLevelMet": {
                        "type": "boolean",
                        "description": "Indicates whether the performance level was met."
                      }
                    },
                    "required": [
                      "performanceLevelDescriptor",
                      "assessmentReportingMethodDescriptor"
                    ]
                  },
                  "description": "A performance level achieved by a student on an objective assessment. Collection child of StudentAssessmentStudentObjectiveAssessment. Items unique by (performanceLevelDescriptor, assessmentReportingMethodDescriptor)."
                },
                "scoreResults": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "assessmentReportingMethodDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The reporting method for this score."
                      },
                      "result": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 35,
                        "description": "The value of the score result."
                      },
                      "resultDatatypeTypeDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "The datatype of the result."
                      }
                    },
                    "required": [
                      "assessmentReportingMethodDescriptor",
                      "result",
                      "resultDatatypeTypeDescriptor"
                    ]
                  },
                  "description": "A score result for a student's performance on an objective assessment within a student assessment event. Collection child of StudentAssessmentStudentObjectiveAssessment. Items unique by (assessmentReportingMethodDescriptor)."
                }
              },
              "required": [
                "objectiveAssessmentIdentificationCode"
              ]
            },
            "description": "A student's performance on an objective assessment within a student assessment event. Collection child of StudentAssessment, capturing per-objective results. Items unique by (objectiveAssessmentIdentificationCode)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student assessment record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentAssessmentEducationOrganizationAssociationRequest": {
        "type": "object",
        "description": "Create-StudentAssessmentEducationOrganizationAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationDate",
          "educationOrganizationSourcedId",
          "educationOrganizationAssociationTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student assessment natural-key student leg.",
            "x-references": "studentAssessment.studentSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationDate"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the student assessment."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the student assessment."
          },
          "administrationDate": {
            "type": "string",
            "format": "date",
            "description": "Administration date of the student assessment."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the student assessment results. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationAssociationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of association being represented."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with the association."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentAssessmentEducationOrganizationAssociationRequest": {
        "type": "object",
        "description": "Update-StudentAssessmentEducationOrganizationAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student assessment natural-key student leg.",
            "x-references": "studentAssessment.studentSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationDate"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the student assessment."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the student assessment."
          },
          "administrationDate": {
            "type": "string",
            "format": "date",
            "description": "Administration date of the student assessment."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization associated with the student assessment results. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationAssociationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of association being represented."
          },
          "schoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with the association."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentAssessmentRegistrationRequest": {
        "type": "object",
        "description": "Create-StudentAssessmentRegistration request body (readOnly/server-managed fields excluded).",
        "required": [
          "assigningEducationOrganizationSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationIdentifier",
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "schoolSourcedId",
          "entryDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assigning education organization of the assessment administration (oneroster:org sourcedId; matches assessmentAdministration natural-key leg).",
            "x-references": "assessmentAdministration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the administration."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assessment namespace of the administration."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the demographic context (also roster-anchored via studentDemographic → oneroster:user).",
            "x-references": "studentDemographic.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the demographic context (leg of studentDemographic natural key; oneroster:org sourcedId)."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the attending studentSchoolAssociation (studentSourcedId + schoolSourcedId + entryDate). Roster FK to oneroster:org; association integrity enforced at command layer.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "entryDate": {
            "type": "string",
            "format": "date",
            "description": "Entry date of the attending studentSchoolAssociation."
          },
          "reportingEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Education organization which should receive the results. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "testingEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Education organization expected to administer the assessment. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentGradeLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Grade level at which the student is to be assessed."
          },
          "platformTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Environment or format for administration."
          },
          "scheduledAccommodationStudentSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional scheduled general accommodation student leg.",
            "x-references": "studentEducationOrganizationAssessmentAccommodation.studentSourcedId",
            "x-references-legs": [
              "scheduledAccommodationEducationOrganizationSourcedId"
            ],
            "x-onDelete": "restrict"
          },
          "scheduledAccommodationEducationOrganizationSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "Optional scheduled general accommodation education organization leg."
          },
          "assessmentAccommodations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Assessment accommodation."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "assessmentAccommodationsItem value."
            },
            "description": "Assessment accommodations for this registration."
          },
          "assessmentCustomizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "customizationKey": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Customization key."
                },
                "customizationValue": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Customization value."
                }
              },
              "required": [
                "customizationKey",
                "customizationValue"
              ],
              "description": "assessmentCustomizationsItem value."
            },
            "description": "Key/value customization pairs."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentAssessmentRegistrationRequest": {
        "type": "object",
        "description": "Update-StudentAssessmentRegistration request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assigning education organization of the assessment administration (oneroster:org sourcedId; matches assessmentAdministration natural-key leg).",
            "x-references": "assessmentAdministration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier of the administration."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assessment namespace of the administration."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the demographic context (also roster-anchored via studentDemographic → oneroster:user).",
            "x-references": "studentDemographic.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the demographic context (leg of studentDemographic natural key; oneroster:org sourcedId)."
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the attending studentSchoolAssociation (studentSourcedId + schoolSourcedId + entryDate). Roster FK to oneroster:org; association integrity enforced at command layer.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "entryDate": {
            "type": "string",
            "format": "date",
            "description": "Entry date of the attending studentSchoolAssociation."
          },
          "reportingEducationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Education organization which should receive the results. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "testingEducationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Education organization expected to administer the assessment. Roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "assessmentGradeLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Grade level at which the student is to be assessed."
          },
          "platformTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Environment or format for administration."
          },
          "scheduledAccommodationStudentSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional scheduled general accommodation student leg.",
            "x-references": "studentEducationOrganizationAssessmentAccommodation.studentSourcedId",
            "x-references-legs": [
              "scheduledAccommodationEducationOrganizationSourcedId"
            ],
            "x-onDelete": "restrict"
          },
          "scheduledAccommodationEducationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Optional scheduled general accommodation education organization leg."
          },
          "assessmentAccommodations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Assessment accommodation."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "assessmentAccommodationsItem value."
            },
            "description": "Assessment accommodations for this registration."
          },
          "assessmentCustomizations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "customizationKey": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Customization key."
                },
                "customizationValue": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Customization value."
                }
              },
              "required": [
                "customizationKey",
                "customizationValue"
              ],
              "description": "assessmentCustomizationsItem value."
            },
            "description": "Key/value customization pairs."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentAssessmentRegistrationBatteryPartAssociationRequest": {
        "type": "object",
        "description": "Create-StudentAssessmentRegistrationBatteryPartAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "assigningEducationOrganizationSourcedId",
          "assessmentIdentifier",
          "namespace",
          "administrationIdentifier",
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "assessmentBatteryPartName",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assigning education organization of the registration.",
            "x-references": "studentAssessmentRegistration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier",
              "studentSourcedId",
              "educationOrganizationSourcedId"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier shared with the registration and the assessmentBatteryPart natural key (assessmentIdentifier + namespace + assessmentBatteryPartName).",
            "x-references": "assessmentBatteryPart.assessmentIdentifier",
            "x-references-legs": [
              "namespace",
              "assessmentBatteryPartName"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assessment namespace."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the registration."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the registration demographic context."
          },
          "assessmentBatteryPartName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Battery part name (third leg of assessmentBatteryPart natural key; FK declared on assessmentIdentifier)."
          },
          "accommodations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Accommodation for this battery part."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "accommodationsItem value."
            },
            "description": "Accommodations for the specific battery part."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentAssessmentRegistrationBatteryPartAssociationRequest": {
        "type": "object",
        "description": "Update-StudentAssessmentRegistrationBatteryPartAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "assigningEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assigning education organization of the registration.",
            "x-references": "studentAssessmentRegistration.assigningEducationOrganizationSourcedId",
            "x-references-legs": [
              "assessmentIdentifier",
              "namespace",
              "administrationIdentifier",
              "studentSourcedId",
              "educationOrganizationSourcedId"
            ],
            "x-onDelete": "cascade"
          },
          "assessmentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Assessment identifier shared with the registration and the assessmentBatteryPart natural key (assessmentIdentifier + namespace + assessmentBatteryPartName).",
            "x-references": "assessmentBatteryPart.assessmentIdentifier",
            "x-references-legs": [
              "namespace",
              "assessmentBatteryPartName"
            ],
            "x-onDelete": "restrict"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Assessment namespace."
          },
          "administrationIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Administration identifier."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the registration."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the registration demographic context."
          },
          "assessmentBatteryPartName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Battery part name (third leg of assessmentBatteryPart natural key; FK declared on assessmentIdentifier)."
          },
          "accommodations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Accommodation for this battery part."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "accommodationsItem value."
            },
            "description": "Accommodations for the specific battery part."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentCTEProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentCTEProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "nonTraditionalGenderStatus": {
            "type": "boolean",
            "description": "Indicator that student is from a gender group that comprises less than 25% of the individuals employed in an occupation or field of work."
          },
          "privateCTEProgram": {
            "type": "boolean",
            "description": "Indicator that student participated in career and technical education at private agencies or institutions."
          },
          "technicalSkillsAssessmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Results of technical skills assessment aligned with industry recognized standards."
          },
          "cteProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "cteProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the CTE program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                },
                "cipCode": {
                  "type": "string",
                  "maxLength": 120,
                  "description": "CIP code associated with the CTE program service."
                }
              },
              "required": [
                "cteProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of cteProgramServiceDescriptor items. Items unique by (cteProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentCTEProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentCTEProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "nonTraditionalGenderStatus": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator that student is from a gender group that comprises less than 25% of the individuals employed in an occupation or field of work."
          },
          "privateCTEProgram": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator that student participated in career and technical education at private agencies or institutions."
          },
          "technicalSkillsAssessmentDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Results of technical skills assessment aligned with industry recognized standards."
          },
          "cteProgramServices": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "cteProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the CTE program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                },
                "cipCode": {
                  "type": "string",
                  "maxLength": 120,
                  "description": "CIP code associated with the CTE program service."
                }
              },
              "required": [
                "cteProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of cteProgramServiceDescriptor items. Items unique by (cteProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentCohortAssociationRequest": {
        "type": "object",
        "description": "Create-StudentCohortAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "cohortIdentifier",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student assigned to the cohort.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined the cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student was assigned to the cohort."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student was removed from the cohort."
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The local identifier assigned to a section."
                },
                "sessionName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identifier for the calendar for the academic session (e.g., '2010/11 Semester 1')."
                }
              },
              "required": [
                "sectionIdentifier",
                "sessionName"
              ]
            },
            "description": "The cohort's associated section(s). A multi-valued collection child of StudentCohortAssociation keyed by the parent's natural key plus the sectionIdentifier and sessionName discriminators. Items unique by (sectionIdentifier, sessionName)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student cohort association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentCohortAssociationRequest": {
        "type": "object",
        "description": "Update-StudentCohortAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student assigned to the cohort.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization that defined the cohort."
          },
          "cohortIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "The name or ID for the cohort."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student was assigned to the cohort."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the student was removed from the cohort."
          },
          "sections": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The local identifier assigned to a section."
                },
                "sessionName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The identifier for the calendar for the academic session (e.g., '2010/11 Semester 1')."
                }
              },
              "required": [
                "sectionIdentifier",
                "sessionName"
              ]
            },
            "description": "The cohort's associated section(s). A multi-valued collection child of StudentCohortAssociation keyed by the parent's natural key plus the sectionIdentifier and sessionName discriminators. Items unique by (sectionIdentifier, sessionName)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student cohort association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentCompetencyObjectiveRequest": {
        "type": "object",
        "description": "Create-StudentCompetencyObjective request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "objectiveSchoolSourcedId",
          "objective",
          "objectiveGradeLevelDescriptor",
          "gradingPeriodSchoolSourcedId",
          "gradingPeriodDescriptor",
          "periodSequence",
          "schoolYear",
          "competencyLevelDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "objectiveSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the competency objective (competencyObjective natural key schoolSourcedId).",
            "x-references": "competencyObjective.schoolSourcedId",
            "x-references-legs": [
              "objective",
              "objectiveGradeLevelDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "objective": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Competency objective title (leg of competencyObjective natural key)."
          },
          "objectiveGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Grade level of the competency objective."
          },
          "gradingPeriodSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the grading period.",
            "x-references": "gradingPeriod.schoolSourcedId",
            "x-references-legs": [
              "gradingPeriodDescriptor",
              "periodSequence",
              "schoolYear"
            ],
            "x-onDelete": "restrict"
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Grading period descriptor."
          },
          "periodSequence": {
            "type": "integer",
            "description": "Grading period sequence."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "School year."
          },
          "competencyLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Competency level assessed."
          },
          "diagnosticStatement": {
            "type": "string",
            "maxLength": 1024,
            "description": "Teacher diagnostic statement."
          },
          "studentSectionAssociations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "schoolSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Section school."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Local course code."
                },
                "schoolYear": {
                  "type": "integer",
                  "description": "School year."
                },
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term."
                },
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Section identifier."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Section association begin date."
                }
              },
              "required": [
                "schoolSourcedId",
                "localCourseCode",
                "schoolYear",
                "termDescriptor",
                "sectionIdentifier",
                "beginDate"
              ],
              "description": "studentSectionAssociationsItem value."
            },
            "description": "Optional related student section associations (choice arm). Nested association integrity enforced at command layer."
          },
          "generalStudentProgramAssociations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student."
                },
                "programEducationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Program education organization."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Program name."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Program type."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Program association begin date."
                }
              },
              "required": [
                "studentSourcedId",
                "programEducationOrganizationSourcedId",
                "programName",
                "programTypeDescriptor",
                "beginDate"
              ],
              "description": "generalStudentProgramAssociationsItem value."
            },
            "description": "Optional related general student program associations (choice arm). Nested association integrity enforced at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentCompetencyObjectiveRequest": {
        "type": "object",
        "description": "Update-StudentCompetencyObjective request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "objectiveSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the competency objective (competencyObjective natural key schoolSourcedId).",
            "x-references": "competencyObjective.schoolSourcedId",
            "x-references-legs": [
              "objective",
              "objectiveGradeLevelDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "objective": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Competency objective title (leg of competencyObjective natural key)."
          },
          "objectiveGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Grade level of the competency objective."
          },
          "gradingPeriodSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "School of the grading period.",
            "x-references": "gradingPeriod.schoolSourcedId",
            "x-references-legs": [
              "gradingPeriodDescriptor",
              "periodSequence",
              "schoolYear"
            ],
            "x-onDelete": "restrict"
          },
          "gradingPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Grading period descriptor."
          },
          "periodSequence": {
            "type": "integer",
            "description": "Grading period sequence."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "School year."
          },
          "competencyLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Competency level assessed."
          },
          "diagnosticStatement": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Teacher diagnostic statement."
          },
          "studentSectionAssociations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "schoolSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Section school."
                },
                "localCourseCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Local course code."
                },
                "schoolYear": {
                  "type": "integer",
                  "description": "School year."
                },
                "termDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Term."
                },
                "sectionIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Section identifier."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Section association begin date."
                }
              },
              "required": [
                "schoolSourcedId",
                "localCourseCode",
                "schoolYear",
                "termDescriptor",
                "sectionIdentifier",
                "beginDate"
              ],
              "description": "studentSectionAssociationsItem value."
            },
            "description": "Optional related student section associations (choice arm). Nested association integrity enforced at command layer."
          },
          "generalStudentProgramAssociations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student."
                },
                "programEducationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Program education organization."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "Program name."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Program type."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Program association begin date."
                }
              },
              "required": [
                "studentSourcedId",
                "programEducationOrganizationSourcedId",
                "programName",
                "programTypeDescriptor",
                "beginDate"
              ],
              "description": "generalStudentProgramAssociationsItem value."
            },
            "description": "Optional related general student program associations (choice arm). Nested association integrity enforced at command layer."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentContactAssociationRequest": {
        "type": "object",
        "description": "Create-StudentContactAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "contactUniqueId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student in this association. Cross-module roster FK.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The contact's unique identifier. Intra-domain FK to the Contact entity.",
            "x-references": "contact.contactUniqueId",
            "x-onDelete": "cascade"
          },
          "relationDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The nature of an individual's relationship to a student (e.g., Father, Mother, Step Father, Guardian)."
          },
          "primaryContactStatus": {
            "type": "boolean",
            "description": "Indicator of whether the person is a primary contactal contact for the student."
          },
          "livesWith": {
            "type": "boolean",
            "description": "Indicator of whether the student lives with the associated contact."
          },
          "emergencyContactStatus": {
            "type": "boolean",
            "description": "Indicator of whether the person is a designated emergency contact for the student."
          },
          "contactPriority": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric order of the preferred sequence of contact."
          },
          "contactRestrictions": {
            "type": "string",
            "maxLength": 250,
            "description": "Restrictions for student and/or teacher contact with the individual (e.g., No contact, Restraining order)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateStudentContactAssociationRequest": {
        "type": "object",
        "description": "Update-StudentContactAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student in this association. Cross-module roster FK.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "contactUniqueId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The contact's unique identifier. Intra-domain FK to the Contact entity.",
            "x-references": "contact.contactUniqueId",
            "x-onDelete": "cascade"
          },
          "relationDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The nature of an individual's relationship to a student (e.g., Father, Mother, Step Father, Guardian)."
          },
          "primaryContactStatus": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator of whether the person is a primary contactal contact for the student."
          },
          "livesWith": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator of whether the student lives with the associated contact."
          },
          "emergencyContactStatus": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator of whether the person is a designated emergency contact for the student."
          },
          "contactPriority": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "The numeric order of the preferred sequence of contact."
          },
          "contactRestrictions": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 250,
            "description": "Restrictions for student and/or teacher contact with the individual (e.g., No contact, Restraining order)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateStudentDemographicRequest": {
        "type": "object",
        "description": "Create-StudentDemographic request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context for these demographics.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The student's birth sex."
          },
          "genderIdentity": {
            "type": "string",
            "maxLength": 60,
            "description": "The student's gender identity as last reported."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "economicDisadvantageDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Economic disadvantage indicator."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Limited English proficiency indicator."
          },
          "supporterMilitaryConnectionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Military connection of the person the student is a dependent of."
          },
          "citizenship": {
            "type": "object",
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation for the individual."
          },
          "ancestryEthnicOrigins": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ancestryEthnicOriginDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Ancestry ethnic origin."
                }
              },
              "required": [
                "ancestryEthnicOriginDescriptor"
              ],
              "description": "ancestryEthnicOriginsItem value."
            },
            "description": "Ancestry ethnic origins."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race category."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race categories."
          },
          "tribalAffiliations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Tribal affiliation."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ],
              "description": "tribalAffiliationsItem value."
            },
            "description": "Tribal affiliations."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages the student uses."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "studentCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Student characteristic."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Who designated the characteristic."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ],
              "description": "studentCharacteristicsItem value."
            },
            "description": "Student characteristics."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentDemographicRequest": {
        "type": "object",
        "description": "Update-StudentDemographic request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context for these demographics.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The student's birth sex."
          },
          "genderIdentity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The student's gender identity as last reported."
          },
          "hispanicLatinoEthnicity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Hispanic/Latino ethnicity indicator."
          },
          "economicDisadvantageDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Economic disadvantage indicator."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Limited English proficiency indicator."
          },
          "supporterMilitaryConnectionDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Military connection of the person the student is a dependent of."
          },
          "citizenship": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "citizenshipStatusDescriptor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 306,
                "description": "Citizenship status."
              },
              "visas": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "visaDescriptor": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 306,
                      "description": "Visa type."
                    }
                  },
                  "required": [
                    "visaDescriptor"
                  ],
                  "description": "visasItem value."
                },
                "description": "Visas associated with citizenship."
              }
            },
            "required": [
              "citizenshipStatusDescriptor"
            ],
            "description": "Citizenship status and related documentation for the individual."
          },
          "ancestryEthnicOrigins": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "ancestryEthnicOriginDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Ancestry ethnic origin."
                }
              },
              "required": [
                "ancestryEthnicOriginDescriptor"
              ],
              "description": "ancestryEthnicOriginsItem value."
            },
            "description": "Ancestry ethnic origins."
          },
          "races": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Race category."
                }
              },
              "required": [
                "raceDescriptor"
              ],
              "description": "racesItem value."
            },
            "description": "Race categories."
          },
          "tribalAffiliations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "tribalAffiliationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Tribal affiliation."
                }
              },
              "required": [
                "tribalAffiliationDescriptor"
              ],
              "description": "tribalAffiliationsItem value."
            },
            "description": "Tribal affiliations."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Language."
                },
                "uses": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "languageUseDescriptor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 306,
                        "description": "Language use."
                      }
                    },
                    "required": [
                      "languageUseDescriptor"
                    ],
                    "description": "usesItem value."
                  },
                  "description": "How the language is used."
                }
              },
              "required": [
                "languageDescriptor"
              ],
              "description": "languagesItem value."
            },
            "description": "Languages the student uses."
          },
          "disabilities": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ],
              "description": "disabilitiesItem value."
            },
            "description": "Disability conditions."
          },
          "studentCharacteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Student characteristic."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Who designated the characteristic."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ],
              "description": "studentCharacteristicsItem value."
            },
            "description": "Student characteristics."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentDirectoryRequest": {
        "type": "object",
        "description": "Create-StudentDirectory request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The email address."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "internationalAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Priority order of this number."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentDirectoryRequest": {
        "type": "object",
        "description": "Update-StudentDirectory request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization context.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address (e.g., Physical, Mailing, Home)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The building or site number."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The city name."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The state abbreviation."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The postal (ZIP) code."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The county name."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The FIPS county code."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude coordinate."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude coordinate."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Indication that the address should not be published."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "Congressional district."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Geographic locale category."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ],
              "description": "addressesItem value."
            },
            "description": "Addresses."
          },
          "electronicMails": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The email address."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "Primary email indicator."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ],
              "description": "electronicMailsItem value."
            },
            "description": "Electronic mail addresses."
          },
          "internationalAddresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address."
                },
                "addressLine1": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "Address line 1."
                },
                "addressLine2": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 2."
                },
                "addressLine3": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 3."
                },
                "addressLine4": {
                  "type": "string",
                  "maxLength": 150,
                  "description": "Address line 4."
                },
                "countryDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Country."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Latitude."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "Longitude."
                },
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Begin date for this address."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "End date for this address."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "addressLine1",
                "countryDescriptor"
              ],
              "description": "internationalAddressesItem value."
            },
            "description": "International addresses."
          },
          "telephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of telephone number."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "description": "Priority order of this number."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "Text message capability."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "Do not publish indicator."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ],
              "description": "telephonesItem value."
            },
            "description": "Telephone numbers."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentDisciplineIncidentBehaviorAssociationRequest": {
        "type": "object",
        "description": "Create-StudentDisciplineIncidentBehaviorAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "incidentIdentifier",
          "behaviorDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student associated with the behavior (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify the DisciplineIncident."
          },
          "behaviorDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Describes behavior by category and provides a detailed description."
          },
          "behaviorDetailedDescription": {
            "type": "string",
            "maxLength": 1024,
            "description": "Specifies a more granular level of detail of a behavior involved in the incident."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentDisciplineIncidentBehaviorAssociationRequest": {
        "type": "object",
        "description": "Update-StudentDisciplineIncidentBehaviorAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student associated with the behavior (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify the DisciplineIncident."
          },
          "behaviorDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Describes behavior by category and provides a detailed description."
          },
          "behaviorDetailedDescription": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Specifies a more granular level of detail of a behavior involved in the incident."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentDisciplineIncidentNonOffenderAssociationRequest": {
        "type": "object",
        "description": "Create-StudentDisciplineIncidentNonOffenderAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "incidentIdentifier",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the non-offending student associated with the discipline incident (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify the DisciplineIncident."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentDisciplineIncidentNonOffenderAssociationRequest": {
        "type": "object",
        "description": "Update-StudentDisciplineIncidentNonOffenderAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the non-offending student associated with the discipline incident (OneRoster roster identity boundary).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school where the incident occurred (OneRoster roster identity boundary).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "incidentIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 36,
            "description": "A locally assigned unique identifier (within the context of the reporting school) to identify the DisciplineIncident."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentEducationOrganizationAssessmentAccommodationRequest": {
        "type": "object",
        "description": "Create-StudentEducationOrganizationAssessmentAccommodation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization determining accommodations.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "generalAccommodations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "General assessment accommodation."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "generalAccommodationsItem value."
            },
            "description": "Special variations for how assessments are presented or administered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentEducationOrganizationAssessmentAccommodationRequest": {
        "type": "object",
        "description": "Update-StudentEducationOrganizationAssessmentAccommodation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization determining accommodations.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "generalAccommodations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "General assessment accommodation."
                }
              },
              "required": [
                "accommodationDescriptor"
              ],
              "description": "generalAccommodationsItem value."
            },
            "description": "Special variations for how assessments are presented or administered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentEducationOrganizationAssociationRequest": {
        "type": "object",
        "description": "Create-StudentEducationOrganizationAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "sexDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student whose demographics are reported in this education organization context.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization reporting the student's demographic information.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A person's gender."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication that the student has been identified as limited English proficient by the Language Proficiency Assessment Committee (LPAC), or equivalent combinating, as specified by each state."
          },
          "oldEthnicityDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Previous definition of ethnicity combining combinating race and ethnicity into a single concept."
          },
          "hispanicLatinoEthnicity": {
            "type": "boolean",
            "description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central, and South America, and other Spanish cultures, regardless of race. The term 'Spanish combinating origin' can be used in addition to 'Hispanic or Latino'."
          },
          "profileThumbnail": {
            "type": "string",
            "maxLength": 2048,
            "description": "URL or reference to a profile thumbnail image for the student in this education organization context."
          },
          "loginId": {
            "type": "string",
            "maxLength": 60,
            "description": "The login ID for the user; the credentials for the user to gain access to the system."
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address listed for an individual (e.g., Physical, Mailing, Home, etc.)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number of an address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which an address is located."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which an address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of local government of an address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which an address is located."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ]
            },
            "description": "The set of elements that describes an address, including the street address, city, state, and ZIP code, associated with a student in the context of an education organization. A multi-valued collection child of StudentEducationOrganizationAssociation keyed by the parent's natural key plus the address type descriptor discriminator. Items unique by (addressTypeDescriptor)."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A disability category that describes a child's impairment."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the disability diagnosis."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order by severity of student's disabilities: 1- Primary, 2 -Secondary, 3 - Tertiary, etc."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The source that provided the disability determination."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "The disability condition(s) that best describes an individual's impairment in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the disability descriptor discriminator. Items unique by (disabilityDescriptor)."
          },
          "electronicMails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email listed for an individual (e.g., Home/Personal, Work, Other)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address listed for an individual."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for an individual."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic email address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "The set of elements that describes an electronic mail address associated with a student in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the electronic mail type descriptor discriminator. Items unique by (electronicMailTypeDescriptor)."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which written or spoken communication is being used."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "The language(s) the individual uses to communicate in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the language descriptor discriminator. Items unique by (languageDescriptor)."
          },
          "races": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category (e.g., American Indian or Alaska Native, Asian, Black or African American, Native Hawaiian or Other Pacific Islander, White)."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "The general racial category which most clearly reflects the individual's recognition of his or her community or with which the individual most identifies in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the race descriptor discriminator. Items unique by (raceDescriptor)."
          },
          "studentCharacteristics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic designated for the student (e.g., Homeless, Migrant, Immigrant, Foster Care, etc.)."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ]
            },
            "description": "Reflects important characteristics of a student in the context of an education organization. If the student characteristic is time-sensitive, a begin/end date pair can be specified. A multi-valued collection child keyed by the parent's natural key plus the student characteristic descriptor discriminator. Items unique by (studentCharacteristicDescriptor)."
          },
          "studentIdentificationCodes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The organization code or name assigning the student identification code."
                },
                "studentIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to a student by a school, school system, a state, or other agency or entity."
                }
              },
              "required": [
                "assigningOrganizationIdentificationCode",
                "studentIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to a student in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the assigning organization identification code and the student identification system descriptor discriminators. Items unique by (assigningOrganizationIdentificationCode, studentIdentificationSystemDescriptor)."
          },
          "telephones": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of communication number listed for an individual (e.g., Home, Work, Mobile, etc.)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code, and extension, if applicable."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "The set of elements that describes a telephone number associated with a student in the context of an education organization. A multi-valued collection child of StudentEducationOrganizationAssociation keyed by the parent's natural key plus the telephone number type descriptor discriminator. Items unique by (telephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentEducationOrganizationAssociationRequest": {
        "type": "object",
        "description": "Update-StudentEducationOrganizationAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student whose demographics are reported in this education organization context.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization reporting the student's demographic information.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "sexDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A person's gender."
          },
          "limitedEnglishProficiencyDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication that the student has been identified as limited English proficient by the Language Proficiency Assessment Committee (LPAC), or equivalent combinating, as specified by each state."
          },
          "oldEthnicityDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "Previous definition of ethnicity combining combinating race and ethnicity into a single concept."
          },
          "hispanicLatinoEthnicity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central, and South America, and other Spanish cultures, regardless of race. The term 'Spanish combinating origin' can be used in addition to 'Hispanic or Latino'."
          },
          "profileThumbnail": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "URL or reference to a profile thumbnail image for the student in this education organization context."
          },
          "loginId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The login ID for the user; the credentials for the user to gain access to the system."
          },
          "addresses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "addressTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of address listed for an individual (e.g., Physical, Mailing, Home, etc.)."
                },
                "streetNumberName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The street number and street name or post office box number of an address."
                },
                "apartmentRoomSuiteNumber": {
                  "type": "string",
                  "maxLength": 50,
                  "description": "The apartment, room, or suite number of an address."
                },
                "buildingSiteNumber": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The number of the building on the site, if more than one building shares the same address."
                },
                "city": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 30,
                  "description": "The name of the city in which an address is located."
                },
                "stateAbbreviationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The abbreviation for the state (within the United States) or outlying area in which an address is located."
                },
                "postalCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 17,
                  "description": "The five or nine digit zip code or overseas postal code portion of an address."
                },
                "nameOfCounty": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The name of the county, parish, borough, or comparable unit of local government of an address."
                },
                "countyFIPSCode": {
                  "type": "string",
                  "maxLength": 5,
                  "description": "The Federal Information Processing Standards (FIPS) numeric code for the county."
                },
                "latitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic latitude of the physical address."
                },
                "longitude": {
                  "type": "string",
                  "maxLength": 20,
                  "description": "The geographic longitude of the physical address."
                },
                "localeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "A general geographic indicator that categorizes U.S. territory (e.g., City, Suburban)."
                },
                "congressionalDistrict": {
                  "type": "string",
                  "maxLength": 30,
                  "description": "The congressional district in which an address is located."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the address should not be published."
                }
              },
              "required": [
                "addressTypeDescriptor",
                "streetNumberName",
                "city",
                "stateAbbreviationDescriptor",
                "postalCode"
              ]
            },
            "description": "The set of elements that describes an address, including the street address, city, state, and ZIP code, associated with a student in the context of an education organization. A multi-valued collection child of StudentEducationOrganizationAssociation keyed by the parent's natural key plus the address type descriptor discriminator. Items unique by (addressTypeDescriptor)."
          },
          "disabilities": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A disability category that describes a child's impairment."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "A description of the disability diagnosis."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order by severity of student's disabilities: 1- Primary, 2 -Secondary, 3 - Tertiary, etc."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "The source that provided the disability determination."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "The disability condition(s) that best describes an individual's impairment in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the disability descriptor discriminator. Items unique by (disabilityDescriptor)."
          },
          "electronicMails": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "electronicMailTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of email listed for an individual (e.g., Home/Personal, Work, Other)."
                },
                "electronicMailAddress": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "description": "The electronic mail (e-mail) address listed for an individual."
                },
                "primaryEmailAddressIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic mail address should be used as the principal electronic mail address for an individual."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the electronic email address should not be published."
                }
              },
              "required": [
                "electronicMailTypeDescriptor",
                "electronicMailAddress"
              ]
            },
            "description": "The set of elements that describes an electronic mail address associated with a student in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the electronic mail type descriptor discriminator. Items unique by (electronicMailTypeDescriptor)."
          },
          "languages": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A specification of which written or spoken communication is being used."
                }
              },
              "required": [
                "languageDescriptor"
              ]
            },
            "description": "The language(s) the individual uses to communicate in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the language descriptor discriminator. Items unique by (languageDescriptor)."
          },
          "races": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "raceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The general racial category (e.g., American Indian or Alaska Native, Asian, Black or African American, Native Hawaiian or Other Pacific Islander, White)."
                }
              },
              "required": [
                "raceDescriptor"
              ]
            },
            "description": "The general racial category which most clearly reflects the individual's recognition of his or her community or with which the individual most identifies in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the race descriptor discriminator. Items unique by (raceDescriptor)."
          },
          "studentCharacteristics": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentCharacteristicDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The characteristic designated for the student (e.g., Homeless, Migrant, Immigrant, Foster Care, etc.)."
                },
                "designatedBy": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the characteristic."
                }
              },
              "required": [
                "studentCharacteristicDescriptor"
              ]
            },
            "description": "Reflects important characteristics of a student in the context of an education organization. If the student characteristic is time-sensitive, a begin/end date pair can be specified. A multi-valued collection child keyed by the parent's natural key plus the student characteristic descriptor discriminator. Items unique by (studentCharacteristicDescriptor)."
          },
          "studentIdentificationCodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "assigningOrganizationIdentificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The organization code or name assigning the student identification code."
                },
                "studentIdentificationSystemDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
                },
                "identificationCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "A unique number or alphanumeric code assigned to a student by a school, school system, a state, or other agency or entity."
                }
              },
              "required": [
                "assigningOrganizationIdentificationCode",
                "studentIdentificationSystemDescriptor",
                "identificationCode"
              ]
            },
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to a student in the context of an education organization. A multi-valued collection child keyed by the parent's natural key plus the assigning organization identification code and the student identification system descriptor discriminators. Items unique by (assigningOrganizationIdentificationCode, studentIdentificationSystemDescriptor)."
          },
          "telephones": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "telephoneNumberTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of communication number listed for an individual (e.g., Home, Work, Mobile, etc.)."
                },
                "telephoneNumber": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 24,
                  "description": "The telephone number including the area code, and extension, if applicable."
                },
                "orderOfPriority": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc."
                },
                "textMessageCapabilityIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number is technically capable of sending and receiving Short Message Service (SMS) text messages."
                },
                "doNotPublishIndicator": {
                  "type": "boolean",
                  "description": "An indication that the telephone number should not be published."
                }
              },
              "required": [
                "telephoneNumberTypeDescriptor",
                "telephoneNumber"
              ]
            },
            "description": "The set of elements that describes a telephone number associated with a student in the context of an education organization. A multi-valued collection child of StudentEducationOrganizationAssociation keyed by the parent's natural key plus the telephone number type descriptor discriminator. Items unique by (telephoneNumberTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentEducationOrganizationResponsibilityAssociationRequest": {
        "type": "object",
        "description": "Create-StudentEducationOrganizationResponsibilityAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "responsibilityDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student for whom the education organization has a responsibility relationship.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization that has responsibility for the student.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "responsibilityDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Indications of an education organization's responsibility for a student (e.g., accountability, attendance, funding)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the education organization assumed responsibility for the student."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the education organization's responsibility for the student ended."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentEducationOrganizationResponsibilityAssociationRequest": {
        "type": "object",
        "description": "Update-StudentEducationOrganizationResponsibilityAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student for whom the education organization has a responsibility relationship.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization that has responsibility for the student.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "responsibilityDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Indications of an education organization's responsibility for a student (e.g., accountability, attendance, funding)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the education organization assumed responsibility for the student."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the education organization's responsibility for the student ended."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentGradebookEntryRequest": {
        "type": "object",
        "description": "Create-StudentGradebookEntry request body (readOnly/server-managed fields excluded).",
        "required": [
          "gradebookEntryIdentifier",
          "namespace",
          "studentSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "gradebookEntryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Gradebook entry identifier.",
            "x-references": "gradebookEntry.gradebookEntryIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the gradebook entry."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "competencyLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Competency level assessed."
          },
          "dateFulfilled": {
            "type": "string",
            "format": "date",
            "description": "The date an assignment was turned in."
          },
          "timeFulfilled": {
            "type": "string",
            "format": "time",
            "description": "The time an assignment was turned in."
          },
          "diagnosticStatement": {
            "type": "string",
            "maxLength": 1024,
            "description": "Teacher diagnostic statement."
          },
          "pointsEarned": {
            "type": "number",
            "description": "Points earned for the submission."
          },
          "letterGradeEarned": {
            "type": "string",
            "maxLength": 20,
            "description": "Letter grade earned."
          },
          "numericGradeEarned": {
            "type": "number",
            "description": "Numeric grade earned."
          },
          "submissionStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Submission status."
          },
          "assignmentLateStatusDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Late status of the assignment."
          },
          "dateCompleted": {
            "type": "string",
            "format": "date",
            "description": "The date the assignment was completed."
          },
          "assignmentPassed": {
            "type": "boolean",
            "description": "Whether the assignment was passed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentGradebookEntryRequest": {
        "type": "object",
        "description": "Update-StudentGradebookEntry request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "gradebookEntryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Gradebook entry identifier.",
            "x-references": "gradebookEntry.gradebookEntryIdentifier",
            "x-references-legs": [
              "namespace"
            ],
            "x-onDelete": "cascade"
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the gradebook entry."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "competencyLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Competency level assessed."
          },
          "dateFulfilled": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date an assignment was turned in."
          },
          "timeFulfilled": {
            "type": [
              "string",
              "null"
            ],
            "format": "time",
            "description": "The time an assignment was turned in."
          },
          "diagnosticStatement": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Teacher diagnostic statement."
          },
          "pointsEarned": {
            "type": [
              "number",
              "null"
            ],
            "description": "Points earned for the submission."
          },
          "letterGradeEarned": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 20,
            "description": "Letter grade earned."
          },
          "numericGradeEarned": {
            "type": [
              "number",
              "null"
            ],
            "description": "Numeric grade earned."
          },
          "submissionStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Submission status."
          },
          "assignmentLateStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Late status of the assignment."
          },
          "dateCompleted": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the assignment was completed."
          },
          "assignmentPassed": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the assignment was passed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentHealthRequest": {
        "type": "object",
        "description": "Create-StudentHealth request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "asOfDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whom the health information relates to.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The educational organization accountable for a student's health information.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "Date of last update of the student's health record."
          },
          "requiredImmunizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "immunizationTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of required immunization."
                },
                "dates": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "immunizationDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date the immunization was received."
                      }
                    },
                    "required": [
                      "immunizationDate"
                    ]
                  },
                  "description": "Dates the immunization was received."
                },
                "medicalExemption": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Medical exemption explanation."
                },
                "medicalExemptionDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date of the medical exemption."
                }
              },
              "required": [
                "immunizationTypeDescriptor"
              ]
            },
            "description": "Required immunizations. Folded Common collection. Items unique by (immunizationTypeDescriptor)."
          },
          "additionalImmunizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "immunizationName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "Name of the additional immunization."
                },
                "dates": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "immunizationDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date the immunization was received."
                      }
                    },
                    "required": [
                      "immunizationDate"
                    ]
                  },
                  "description": "Dates the immunization was received."
                }
              },
              "required": [
                "immunizationName"
              ]
            },
            "description": "Additional immunizations. Folded Common collection. Items unique by (immunizationName)."
          },
          "nonMedicalImmunizationExemptionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of nonmedical exemption from vaccination claimed by the student's parent or guardian."
          },
          "nonMedicalImmunizationExemptionDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the nonmedical exemption from vaccination."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentHealthRequest": {
        "type": "object",
        "description": "Update-StudentHealth request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whom the health information relates to.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The educational organization accountable for a student's health information.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "asOfDate": {
            "type": "string",
            "format": "date",
            "description": "Date of last update of the student's health record."
          },
          "requiredImmunizations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "immunizationTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of required immunization."
                },
                "dates": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "immunizationDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date the immunization was received."
                      }
                    },
                    "required": [
                      "immunizationDate"
                    ]
                  },
                  "description": "Dates the immunization was received."
                },
                "medicalExemption": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Medical exemption explanation."
                },
                "medicalExemptionDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Date of the medical exemption."
                }
              },
              "required": [
                "immunizationTypeDescriptor"
              ]
            },
            "description": "Required immunizations. Folded Common collection. Items unique by (immunizationTypeDescriptor)."
          },
          "additionalImmunizations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "immunizationName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "description": "Name of the additional immunization."
                },
                "dates": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "immunizationDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date the immunization was received."
                      }
                    },
                    "required": [
                      "immunizationDate"
                    ]
                  },
                  "description": "Dates the immunization was received."
                }
              },
              "required": [
                "immunizationName"
              ]
            },
            "description": "Additional immunizations. Folded Common collection. Items unique by (immunizationName)."
          },
          "nonMedicalImmunizationExemptionDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of nonmedical exemption from vaccination claimed by the student's parent or guardian."
          },
          "nonMedicalImmunizationExemptionDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date of the nonmedical exemption from vaccination."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentHomelessProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentHomelessProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "homelessPrimaryNighttimeResidenceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The primary nighttime residence of the student at the time the student is identified as homeless."
          },
          "awaitingFosterCare": {
            "type": "boolean",
            "description": "State defined definition for awaiting foster care."
          },
          "homelessUnaccompaniedYouth": {
            "type": "boolean",
            "description": "A homeless unaccompanied youth is a youth who is not in the physical custody of a parent or guardian and who fits the McKinney-Vento definition of homeless."
          },
          "homelessProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "homelessProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the homeless program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "homelessProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of homelessProgramServiceDescriptor items. Items unique by (homelessProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentHomelessProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentHomelessProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "homelessPrimaryNighttimeResidenceDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The primary nighttime residence of the student at the time the student is identified as homeless."
          },
          "awaitingFosterCare": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "State defined definition for awaiting foster care."
          },
          "homelessUnaccompaniedYouth": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "A homeless unaccompanied youth is a youth who is not in the physical custody of a parent or guardian and who fits the McKinney-Vento definition of homeless."
          },
          "homelessProgramServices": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "homelessProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the homeless program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "homelessProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of homelessProgramServiceDescriptor items. Items unique by (homelessProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentIdentificationCodeRequest": {
        "type": "object",
        "description": "Create-StudentIdentificationCode request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "assigningOrganizationIdentificationCode",
          "studentIdentificationSystemDescriptor",
          "identificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student this identification code belongs to (references the oneroster:user record backing edfi:student).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "cascade"
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The organization code or name assigning the student identification code."
          },
          "studentIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a student by a school, school system, state, or other agency or entity."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "UpdateStudentIdentificationCodeRequest": {
        "type": "object",
        "description": "Update-StudentIdentificationCode request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student this identification code belongs to (references the oneroster:user record backing edfi:student).",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "cascade"
          },
          "assigningOrganizationIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The organization code or name assigning the student identification code."
          },
          "studentIdentificationSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies."
          },
          "identificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to a student by a school, school system, state, or other agency or entity."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action."
          }
        }
      },
      "CreateStudentIepRequest": {
        "type": "object",
        "description": "Create-StudentIep request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "studentIepIdentifier",
          "iepFinalizedDate",
          "iepBeginDate",
          "iepEndDate",
          "iepStatusDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the IEP.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the student IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "The date the IEP was finalized."
          },
          "iepBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the IEP."
          },
          "iepEndDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the IEP."
          },
          "iepStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The status of the IEP."
          },
          "accommodations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Accommodation provided under the IEP."
                }
              },
              "required": [
                "accommodationDescriptor"
              ]
            },
            "description": "Accommodations associated with the IEP."
          },
          "disabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "Disability conditions."
          },
          "ideaEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "iepAmendedDate": {
            "type": "string",
            "format": "date",
            "description": "The date the IEP was amended."
          },
          "medicallyFragile": {
            "type": "boolean",
            "description": "Indicates whether the student is medically fragile."
          },
          "multiplyDisabled": {
            "type": "boolean",
            "description": "Indicates whether the student is multiply disabled."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student exited the IEP."
          },
          "schoolHoursPerWeek": {
            "type": "number",
            "description": "School hours per week."
          },
          "specialEducationHoursPerWeek": {
            "type": "number",
            "description": "Special education hours per week."
          },
          "specialEducationSettingDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The special education setting."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentIepRequest": {
        "type": "object",
        "description": "Update-StudentIep request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The education organization that owns the IEP.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the student IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "The date the IEP was finalized."
          },
          "iepBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The begin date of the IEP."
          },
          "iepEndDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the IEP."
          },
          "iepStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The status of the IEP."
          },
          "accommodations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "accommodationDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Accommodation provided under the IEP."
                }
              },
              "required": [
                "accommodationDescriptor"
              ]
            },
            "description": "Accommodations associated with the IEP."
          },
          "disabilities": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "disabilityDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Disability condition."
                },
                "disabilityDiagnosis": {
                  "type": "string",
                  "maxLength": 80,
                  "description": "Disability diagnosis text."
                },
                "orderOfDisability": {
                  "type": "integer",
                  "description": "Order of disability."
                },
                "disabilityDeterminationSourceTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Determination source type."
                }
              },
              "required": [
                "disabilityDescriptor"
              ]
            },
            "description": "Disability conditions."
          },
          "ideaEvents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "iepAmendedDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the IEP was amended."
          },
          "medicallyFragile": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student is medically fragile."
          },
          "multiplyDisabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student is multiply disabled."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason the student exited the IEP."
          },
          "schoolHoursPerWeek": {
            "type": [
              "number",
              "null"
            ],
            "description": "School hours per week."
          },
          "specialEducationHoursPerWeek": {
            "type": [
              "number",
              "null"
            ],
            "description": "Special education hours per week."
          },
          "specialEducationSettingDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The special education setting."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentIepGoalRequest": {
        "type": "object",
        "description": "Create-StudentIepGoal request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "studentIepIdentifier",
          "iepFinalizedDate",
          "iepGoalIdentifier",
          "iepGoalDetails",
          "iepGoalTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "iepGoalIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the IEP goal."
          },
          "iepGoalDetails": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Details of the IEP goal."
          },
          "iepGoalTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of IEP goal."
          },
          "achievementPeriod": {
            "type": "object",
            "properties": {
              "beginDate": {
                "type": "string",
                "format": "date",
                "description": "Achievement period begin date."
              },
              "endDate": {
                "type": "string",
                "format": "date",
                "description": "Achievement period end date."
              }
            },
            "description": "The achievement period for the goal."
          },
          "ideaEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentIepGoalRequest": {
        "type": "object",
        "description": "Update-StudentIepGoal request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "iepGoalIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the IEP goal."
          },
          "iepGoalDetails": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "Details of the IEP goal."
          },
          "iepGoalTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of IEP goal."
          },
          "achievementPeriod": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "beginDate": {
                "type": "string",
                "format": "date",
                "description": "Achievement period begin date."
              },
              "endDate": {
                "type": "string",
                "format": "date",
                "description": "Achievement period end date."
              }
            },
            "description": "The achievement period for the goal."
          },
          "ideaEvents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentIepServiceDeliveryRequest": {
        "type": "object",
        "description": "Create-StudentIepServiceDelivery request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "studentIepIdentifier",
          "iepFinalizedDate",
          "iepServiceDeliveryIdentifier",
          "serviceDeliveryDescriptor",
          "serviceDeliveryDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "iepServiceDeliveryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the service delivery."
          },
          "serviceDeliveryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The service delivered."
          },
          "serviceDeliveryDate": {
            "type": "string",
            "format": "date",
            "description": "The date the service was delivered."
          },
          "ideaEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "providers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Provider first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Provider last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Provider middle name."
                },
                "primaryProvider": {
                  "type": "boolean",
                  "description": "Whether this is the primary provider."
                },
                "providerCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Provider code."
                },
                "serviceProviderTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Type of service provider."
                },
                "staffSourcedId": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "Optional staff sourcedId."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Providers who delivered the service."
          },
          "servicePrescriptionDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Optional parent service prescription descriptor (command-layer validated)."
          },
          "servicePrescriptionDate": {
            "type": "string",
            "format": "date",
            "description": "Optional parent service prescription date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentIepServiceDeliveryRequest": {
        "type": "object",
        "description": "Update-StudentIepServiceDelivery request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "iepServiceDeliveryIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "A unique identifier for the service delivery."
          },
          "serviceDeliveryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The service delivered."
          },
          "serviceDeliveryDate": {
            "type": "string",
            "format": "date",
            "description": "The date the service was delivered."
          },
          "ideaEvents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "providers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "firstName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Provider first name."
                },
                "lastSurname": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 75,
                  "description": "Provider last surname."
                },
                "middleName": {
                  "type": "string",
                  "maxLength": 75,
                  "description": "Provider middle name."
                },
                "primaryProvider": {
                  "type": "boolean",
                  "description": "Whether this is the primary provider."
                },
                "providerCode": {
                  "type": "string",
                  "maxLength": 60,
                  "description": "Provider code."
                },
                "serviceProviderTypeDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Type of service provider."
                },
                "staffSourcedId": {
                  "type": "string",
                  "maxLength": 255,
                  "description": "Optional staff sourcedId."
                }
              },
              "required": [
                "firstName",
                "lastSurname"
              ]
            },
            "description": "Providers who delivered the service."
          },
          "servicePrescriptionDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Optional parent service prescription descriptor (command-layer validated)."
          },
          "servicePrescriptionDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Optional parent service prescription date."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentIepServicePrescriptionRequest": {
        "type": "object",
        "description": "Create-StudentIepServicePrescription request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "studentIepIdentifier",
          "iepFinalizedDate",
          "servicePrescriptionDescriptor",
          "servicePrescriptionDate",
          "beginDate",
          "duration",
          "durationIntervalDescriptor",
          "frequency",
          "frequencyIntervalDescriptor",
          "serviceLocationTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "servicePrescriptionDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The prescribed service."
          },
          "servicePrescriptionDate": {
            "type": "string",
            "format": "date",
            "description": "The date the service was prescribed."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Service prescription begin date."
          },
          "duration": {
            "type": "integer",
            "description": "Duration of each service delivery."
          },
          "durationIntervalDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Interval unit for duration."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Service prescription end date."
          },
          "frequency": {
            "type": "number",
            "description": "Frequency of the service."
          },
          "frequencyIntervalDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Interval unit for frequency."
          },
          "serviceLocationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Where the service is delivered."
          },
          "ideaEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "staffs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "staffSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Staff member associated with the prescription."
                }
              },
              "required": [
                "staffSourcedId"
              ]
            },
            "description": "Staff associated with the service prescription (natural-key stubs)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentIepServicePrescriptionRequest": {
        "type": "object",
        "description": "Update-StudentIepServicePrescription request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student of the parent IEP.",
            "x-references": "studentIep.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "studentIepIdentifier",
              "iepFinalizedDate"
            ],
            "x-onDelete": "cascade"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent IEP."
          },
          "studentIepIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Identifier of the parent IEP."
          },
          "iepFinalizedDate": {
            "type": "string",
            "format": "date",
            "description": "Finalized date of the parent IEP."
          },
          "servicePrescriptionDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The prescribed service."
          },
          "servicePrescriptionDate": {
            "type": "string",
            "format": "date",
            "description": "The date the service was prescribed."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Service prescription begin date."
          },
          "duration": {
            "type": "integer",
            "description": "Duration of each service delivery."
          },
          "durationIntervalDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Interval unit for duration."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Service prescription end date."
          },
          "frequency": {
            "type": "number",
            "description": "Frequency of the service."
          },
          "frequencyIntervalDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Interval unit for frequency."
          },
          "serviceLocationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Where the service is delivered."
          },
          "ideaEvents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "studentSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Student of the IDEA event."
                },
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Education organization of the IDEA event."
                },
                "ideaEventIdentifier": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 120,
                  "description": "IDEA event identifier."
                },
                "ideaEventTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "IDEA event type."
                }
              },
              "required": [
                "studentSourcedId",
                "educationOrganizationSourcedId",
                "ideaEventIdentifier",
                "ideaEventTypeDescriptor"
              ]
            },
            "description": "IDEA events associated with this record (natural-key stubs; validated at command layer)."
          },
          "staffs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "staffSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "Staff member associated with the prescription."
                }
              },
              "required": [
                "staffSourcedId"
              ]
            },
            "description": "Staff associated with the service prescription (natural-key stubs)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentInterventionAssociationRequest": {
        "type": "object",
        "description": "Create-StudentInterventionAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "interventionIdentificationCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student participating in the intervention.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "dosage": {
            "type": "integer",
            "description": "The duration in minutes of the intervention."
          },
          "diagnosticStatement": {
            "type": "string",
            "maxLength": 1024,
            "description": "A diagnostic statement describing the student's need for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student intervention association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentInterventionAssociationRequest": {
        "type": "object",
        "description": "Update-StudentInterventionAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student participating in the intervention.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "dosage": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The duration in minutes of the intervention."
          },
          "diagnosticStatement": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "A diagnostic statement describing the student's need for the intervention."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student intervention association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentInterventionAttendanceEventRequest": {
        "type": "object",
        "description": "Create-StudentInterventionAttendanceEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "interventionIdentificationCode",
          "eventDate",
          "attendanceEventCategoryDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student whose attendance is recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence)."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "The reported reason for a student's absence or tardy."
          },
          "eventDuration": {
            "type": "number",
            "description": "The amount of time in hours for the attendance event."
          },
          "interventionDuration": {
            "type": "integer",
            "description": "The duration in minutes of the intervention session."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student intervention attendance event record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentInterventionAttendanceEventRequest": {
        "type": "object",
        "description": "Update-StudentInterventionAttendanceEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student whose attendance is recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the intervention."
          },
          "interventionIdentificationCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the intervention."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence)."
          },
          "attendanceEventReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The reported reason for a student's absence or tardy."
          },
          "eventDuration": {
            "type": [
              "number",
              "null"
            ],
            "description": "The amount of time in hours for the attendance event."
          },
          "interventionDuration": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The duration in minutes of the intervention session."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student intervention attendance event record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentLanguageInstructionProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentLanguageInstructionProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "englishLearnerParticipation": {
            "type": "boolean",
            "description": "An indication that an English learner student is served by an English language instruction educational program supported with Title III of ESEA funds."
          },
          "dosage": {
            "type": "integer",
            "description": "The duration of time in minutes for which the student was assigned to participate in the program."
          },
          "englishLanguageProficiencyAssessments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "School year of the English language proficiency assessment."
                },
                "participationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Participation result."
                },
                "proficiencyDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Proficiency result."
                },
                "progressDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Progress result."
                },
                "monitoredDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Monitored status."
                }
              },
              "required": [
                "schoolYear"
              ]
            },
            "description": "Results of yearly English language assessment. Folded Common collection. Items unique by (schoolYear)."
          },
          "languageInstructionProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "languageInstructionProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the language instruction program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "languageInstructionProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of languageInstructionProgramServiceDescriptor items. Items unique by (languageInstructionProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentLanguageInstructionProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentLanguageInstructionProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "englishLearnerParticipation": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication that an English learner student is served by an English language instruction educational program supported with Title III of ESEA funds."
          },
          "dosage": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The duration of time in minutes for which the student was assigned to participate in the program."
          },
          "englishLanguageProficiencyAssessments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "schoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "School year of the English language proficiency assessment."
                },
                "participationDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Participation result."
                },
                "proficiencyDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Proficiency result."
                },
                "progressDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Progress result."
                },
                "monitoredDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Monitored status."
                }
              },
              "required": [
                "schoolYear"
              ]
            },
            "description": "Results of yearly English language assessment. Folded Common collection. Items unique by (schoolYear)."
          },
          "languageInstructionProgramServices": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "languageInstructionProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the language instruction program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "languageInstructionProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of languageInstructionProgramServiceDescriptor items. Items unique by (languageInstructionProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentMigrantEducationProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentMigrantEducationProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "priorityForServices",
          "lastQualifyingMove"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "priorityForServices": {
            "type": "boolean",
            "description": "Report migratory children who are classified as having priority for services."
          },
          "lastQualifyingMove": {
            "type": "string",
            "format": "date",
            "description": "Date the last qualifying move occurred; used to compute MEP status."
          },
          "continuationOfServicesReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The continuation of services provision reason."
          },
          "usInitialEntry": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student first entered the U.S."
          },
          "usMostRecentEntry": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year of the student's most recent entry into the U.S."
          },
          "usInitialSchoolEntry": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student first entered a U.S. school."
          },
          "qualifyingArrivalDate": {
            "type": "string",
            "format": "date",
            "description": "The qualifying arrival date (QAD)."
          },
          "stateResidencyDate": {
            "type": "string",
            "format": "date",
            "description": "The verified state residency for the student."
          },
          "eligibilityExpirationDate": {
            "type": "string",
            "format": "date",
            "description": "The eligibility expiration date used to determine end of eligibility."
          },
          "migrantEducationProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "migrantEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the migrant education program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "migrantEducationProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of migrantEducationProgramServiceDescriptor items. Items unique by (migrantEducationProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentMigrantEducationProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentMigrantEducationProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "priorityForServices": {
            "type": "boolean",
            "description": "Report migratory children who are classified as having priority for services."
          },
          "lastQualifyingMove": {
            "type": "string",
            "format": "date",
            "description": "Date the last qualifying move occurred; used to compute MEP status."
          },
          "continuationOfServicesReasonDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The continuation of services provision reason."
          },
          "usInitialEntry": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student first entered the U.S."
          },
          "usMostRecentEntry": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year of the student's most recent entry into the U.S."
          },
          "usInitialSchoolEntry": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student first entered a U.S. school."
          },
          "qualifyingArrivalDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The qualifying arrival date (QAD)."
          },
          "stateResidencyDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The verified state residency for the student."
          },
          "eligibilityExpirationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The eligibility expiration date used to determine end of eligibility."
          },
          "migrantEducationProgramServices": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "migrantEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the migrant education program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "migrantEducationProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of migrantEducationProgramServiceDescriptor items. Items unique by (migrantEducationProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentNeglectedOrDelinquentProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentNeglectedOrDelinquentProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "neglectedOrDelinquentProgramDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The type of program under ESEA Title I, Part D, Subpart 1 (state programs) or Subpart 2 (LEA)."
          },
          "elaProgressLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The progress measured from pre- to post- test for ELA."
          },
          "mathematicsProgressLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The progress measured from pre- to post-test for Mathematics."
          },
          "neglectedOrDelinquentProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "neglectedOrDelinquentProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the neglected or delinquent program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "neglectedOrDelinquentProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of neglectedOrDelinquentProgramServiceDescriptor items. Items unique by (neglectedOrDelinquentProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentNeglectedOrDelinquentProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentNeglectedOrDelinquentProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "neglectedOrDelinquentProgramDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The type of program under ESEA Title I, Part D, Subpart 1 (state programs) or Subpart 2 (LEA)."
          },
          "elaProgressLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The progress measured from pre- to post- test for ELA."
          },
          "mathematicsProgressLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The progress measured from pre- to post-test for Mathematics."
          },
          "neglectedOrDelinquentProgramServices": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "neglectedOrDelinquentProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the neglected or delinquent program."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this service option."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this service option."
                }
              },
              "required": [
                "neglectedOrDelinquentProgramServiceDescriptor"
              ]
            },
            "description": "Folded Common collection of neglectedOrDelinquentProgramServiceDescriptor items. Items unique by (neglectedOrDelinquentProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentPathRequest": {
        "type": "object",
        "description": "Create-StudentPath request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "pathName",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with the path. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the path. Part of Path natural key.",
            "x-references": "path.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Name of the path."
          },
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Effective date periods."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentPathRequest": {
        "type": "object",
        "description": "Update-StudentPath request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with the path. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the path. Part of Path natural key.",
            "x-references": "path.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Name of the path."
          },
          "periods": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Effective date periods."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentPathMilestoneStatusRequest": {
        "type": "object",
        "description": "Create-StudentPathMilestoneStatus request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "pathName",
          "pathMilestoneName",
          "pathMilestoneTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the parent StudentPath.",
            "x-references": "studentPath.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent StudentPath/Path."
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path name of the parent StudentPath."
          },
          "pathMilestoneName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Referenced path milestone name.",
            "x-references": "pathMilestone.pathMilestoneName",
            "x-references-legs": [
              "pathMilestoneTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "pathMilestoneTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Referenced path milestone type."
          },
          "completionIndicator": {
            "type": "boolean",
            "description": "Whether the milestone is complete."
          },
          "pathMilestoneStatusEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "pathMilestoneStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Milestone status."
                },
                "pathMilestoneStatusDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Status date."
                },
                "description": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Status event description."
                }
              },
              "required": [
                "pathMilestoneStatusDescriptor",
                "pathMilestoneStatusDate"
              ],
              "description": "pathMilestoneStatusEventsItem value."
            },
            "description": "Status events for this milestone (folded)."
          },
          "pathPhaseName": {
            "type": "string",
            "maxLength": 60,
            "description": "Optional path phase name within the same path."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentPathMilestoneStatusRequest": {
        "type": "object",
        "description": "Update-StudentPathMilestoneStatus request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the parent StudentPath.",
            "x-references": "studentPath.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent StudentPath/Path."
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path name of the parent StudentPath."
          },
          "pathMilestoneName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Referenced path milestone name.",
            "x-references": "pathMilestone.pathMilestoneName",
            "x-references-legs": [
              "pathMilestoneTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "pathMilestoneTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Referenced path milestone type."
          },
          "completionIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the milestone is complete."
          },
          "pathMilestoneStatusEvents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "pathMilestoneStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Milestone status."
                },
                "pathMilestoneStatusDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Status date."
                },
                "description": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "Status event description."
                }
              },
              "required": [
                "pathMilestoneStatusDescriptor",
                "pathMilestoneStatusDate"
              ],
              "description": "pathMilestoneStatusEventsItem value."
            },
            "description": "Status events for this milestone (folded)."
          },
          "pathPhaseName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "Optional path phase name within the same path."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentPathPhaseStatusRequest": {
        "type": "object",
        "description": "Create-StudentPathPhaseStatus request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationSourcedId",
          "pathName",
          "pathPhaseName",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the parent StudentPath.",
            "x-references": "studentPath.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent path/phase.",
            "x-references": "pathPhase.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName",
              "pathPhaseName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path name."
          },
          "pathPhaseName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path phase name."
          },
          "completionIndicator": {
            "type": "boolean",
            "description": "Whether the phase is complete."
          },
          "pathPhaseStatusEvents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "pathPhaseStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Phase status."
                },
                "pathPhaseStatusDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Status date."
                }
              },
              "required": [
                "pathPhaseStatusDescriptor",
                "pathPhaseStatusDate"
              ],
              "description": "pathPhaseStatusEventsItem value."
            },
            "description": "Status events for this phase (folded)."
          },
          "periods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Effective date periods."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentPathPhaseStatusRequest": {
        "type": "object",
        "description": "Update-StudentPathPhaseStatus request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student of the parent StudentPath.",
            "x-references": "studentPath.studentSourcedId",
            "x-references-legs": [
              "educationOrganizationSourcedId",
              "pathName"
            ],
            "x-onDelete": "restrict"
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent path/phase.",
            "x-references": "pathPhase.educationOrganizationSourcedId",
            "x-references-legs": [
              "pathName",
              "pathPhaseName"
            ],
            "x-onDelete": "restrict"
          },
          "pathName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path name."
          },
          "pathPhaseName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Path phase name."
          },
          "completionIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the phase is complete."
          },
          "pathPhaseStatusEvents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "pathPhaseStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Phase status."
                },
                "pathPhaseStatusDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Status date."
                }
              },
              "required": [
                "pathPhaseStatusDescriptor",
                "pathPhaseStatusDate"
              ],
              "description": "pathPhaseStatusEventsItem value."
            },
            "description": "Status events for this phase (folded)."
          },
          "periods": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "beginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period begin date."
                },
                "endDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Period end date."
                }
              },
              "required": [
                "beginDate"
              ],
              "description": "periodsItem value."
            },
            "description": "Effective date periods."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student participating in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program. Typically, this is the date the student becomes eligible for the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's program participation over time. A multi-valued collection child of studentProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student participating in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program. Typically, this is the date the student becomes eligible for the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's program participation over time. A multi-valued collection child of studentProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentProgramAttendanceEventRequest": {
        "type": "object",
        "description": "Create-StudentProgramAttendanceEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "eventDate",
          "attendanceEventCategoryDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with the attendance event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the program (and where the student is participating). Program natural-key leg; oneroster:org sourcedId.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the program."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the attendance event (e.g., In Attendance, Excused Absence)."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "The reported reason for a student's absence or tardy."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which a student receives education and related services."
          },
          "eventDuration": {
            "type": "number",
            "description": "The amount of time for the event as decimal hours."
          },
          "programAttendanceDuration": {
            "type": "integer",
            "description": "The duration in minutes of the program attendance event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentProgramAttendanceEventRequest": {
        "type": "object",
        "description": "Update-StudentProgramAttendanceEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student associated with the attendance event.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the program (and where the student is participating). Program natural-key leg; oneroster:org sourcedId.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the program."
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of the attendance event (e.g., In Attendance, Excused Absence)."
          },
          "attendanceEventReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The reported reason for a student's absence or tardy."
          },
          "educationalEnvironmentDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The setting in which a student receives education and related services."
          },
          "eventDuration": {
            "type": [
              "number",
              "null"
            ],
            "description": "The amount of time for the event as decimal hours."
          },
          "programAttendanceDuration": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The duration in minutes of the program attendance event."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentProgramEvaluationRequest": {
        "type": "object",
        "description": "Create-StudentProgramEvaluation request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "programEvaluationTitle",
          "programEvaluationPeriodDescriptor",
          "programEvaluationTypeDescriptor",
          "studentSourcedId",
          "evaluationDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program evaluation (programEvaluation natural-key leg).",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Program name leg of the parent program evaluation."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Program type leg of the parent program evaluation."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title leg of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Period leg of the parent program evaluation."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type leg of the parent program evaluation."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student being evaluated on behalf of the program.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the evaluation was conducted."
          },
          "evaluatingEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Optional education organization that evaluated the student (may differ from the program's education organization).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationDuration": {
            "type": "integer",
            "description": "The actual number of minutes to conduct the evaluation."
          },
          "summaryEvaluationNumericRating": {
            "type": "number",
            "description": "The numerical summary rating or score for the evaluation."
          },
          "summaryEvaluationRatingLevelDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The summary rating level achieved based upon the rating or score."
          },
          "summaryEvaluationComment": {
            "type": "string",
            "maxLength": 1024,
            "description": "Any comments about the summary evaluation to be captured."
          },
          "staffEvaluatorStaffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Reference to the staff that evaluated the student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "externalEvaluators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "externalEvaluator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The external person that conducted the evaluation."
                }
              },
              "required": [
                "externalEvaluator"
              ]
            },
            "description": "External person(s) - not staff - that conducted the evaluation. Folded collection."
          },
          "studentEvaluationObjectives": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "programEvaluationObjectiveTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the program evaluation objective (discriminator within the parent evaluation)."
                },
                "evaluationObjectiveNumericRating": {
                  "type": "number",
                  "description": "Numeric rating for the objective."
                },
                "evaluationObjectiveRatingLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Rating level for the objective."
                }
              },
              "required": [
                "programEvaluationObjectiveTitle"
              ]
            },
            "description": "Student ratings for program evaluation objectives. Folded Common; objective title is the local discriminator (full objective FK validated at command layer)."
          },
          "studentEvaluationElements": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "programEvaluationElementTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the program evaluation element (discriminator within the parent evaluation)."
                },
                "evaluationElementNumericRating": {
                  "type": "number",
                  "description": "Numeric rating for the element."
                },
                "evaluationElementRatingLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Rating level for the element."
                }
              },
              "required": [
                "programEvaluationElementTitle"
              ]
            },
            "description": "Student ratings for program evaluation elements. Folded Common; element title is the local discriminator (full element FK validated at command layer)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentProgramEvaluationRequest": {
        "type": "object",
        "description": "Update-StudentProgramEvaluation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the parent program evaluation (programEvaluation natural-key leg).",
            "x-references": "programEvaluation.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor",
              "programEvaluationTitle",
              "programEvaluationPeriodDescriptor",
              "programEvaluationTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Program name leg of the parent program evaluation."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Program type leg of the parent program evaluation."
          },
          "programEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Title leg of the parent program evaluation."
          },
          "programEvaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Period leg of the parent program evaluation."
          },
          "programEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Type leg of the parent program evaluation."
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student being evaluated on behalf of the program.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the evaluation was conducted."
          },
          "evaluatingEducationOrganizationSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "description": "Optional education organization that evaluated the student (may differ from the program's education organization).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "evaluationDuration": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The actual number of minutes to conduct the evaluation."
          },
          "summaryEvaluationNumericRating": {
            "type": [
              "number",
              "null"
            ],
            "description": "The numerical summary rating or score for the evaluation."
          },
          "summaryEvaluationRatingLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The summary rating level achieved based upon the rating or score."
          },
          "summaryEvaluationComment": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Any comments about the summary evaluation to be captured."
          },
          "staffEvaluatorStaffSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "description": "Reference to the staff that evaluated the student.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "externalEvaluators": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "externalEvaluator": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 150,
                  "description": "The external person that conducted the evaluation."
                }
              },
              "required": [
                "externalEvaluator"
              ]
            },
            "description": "External person(s) - not staff - that conducted the evaluation. Folded collection."
          },
          "studentEvaluationObjectives": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "programEvaluationObjectiveTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the program evaluation objective (discriminator within the parent evaluation)."
                },
                "evaluationObjectiveNumericRating": {
                  "type": "number",
                  "description": "Numeric rating for the objective."
                },
                "evaluationObjectiveRatingLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Rating level for the objective."
                }
              },
              "required": [
                "programEvaluationObjectiveTitle"
              ]
            },
            "description": "Student ratings for program evaluation objectives. Folded Common; objective title is the local discriminator (full objective FK validated at command layer)."
          },
          "studentEvaluationElements": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "programEvaluationElementTitle": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50,
                  "description": "Title of the program evaluation element (discriminator within the parent evaluation)."
                },
                "evaluationElementNumericRating": {
                  "type": "number",
                  "description": "Numeric rating for the element."
                },
                "evaluationElementRatingLevelDescriptor": {
                  "type": "string",
                  "maxLength": 306,
                  "description": "Rating level for the element."
                }
              },
              "required": [
                "programEvaluationElementTitle"
              ]
            },
            "description": "Student ratings for program evaluation elements. Folded Common; element title is the local discriminator (full element FK validated at command layer)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentSchoolAssociationRequest": {
        "type": "object",
        "description": "Create-StudentSchoolAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "entryDate",
          "entryGradeLevelDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student enrolled in this school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the school enrolling the student.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "entryDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an individual enters and begins to receive instructional services in a school."
          },
          "exitWithdrawDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year of the first day after the date of an individual's last attendance at a school (if known), the day on which an individual graduated, or the date on which it becomes known officially that an individual left school."
          },
          "primarySchool": {
            "type": "boolean",
            "description": "Indicates if a given enrollment record should be considered the primary record for a student."
          },
          "entryGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grade level or primary instructional level at which a student enters and receives services in a school or an educational institution during a given academic session."
          },
          "entryGradeLevelReasonDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The primary reason as to why a staff member determined that a student should be promoted or not (or be demoted) at the end of a given school term."
          },
          "entryTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The process by which a student enters a school during a given academic session."
          },
          "exitWithdrawTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The circumstances under which the student exited from membership in an educational institution."
          },
          "repeatGradeIndicator": {
            "type": "boolean",
            "description": "An indicator of whether the student is enrolling to repeat a grade level, either by failure or an agreement to repeat."
          },
          "classOfSchoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "Projected high school graduation year."
          },
          "schoolChoiceTransfer": {
            "type": "boolean",
            "description": "An indication of whether students transferred in or out of the school did so during the school year under the provisions for public school choice in accordance with Title I, Part A, Section 1116."
          },
          "schoolChoice": {
            "type": "boolean",
            "description": "An indication that the student transferred to the school under a school choice provision."
          },
          "schoolChoiceBasisDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The legal basis for the school choice enrollment according to local, state or federal policy or regulation."
          },
          "residencyStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the location of a persons legal residence relative to (within or outside of) the boundaries of the public school attended and its administrative unit."
          },
          "graduationPlanTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of academic plan the student is following for graduation."
          },
          "graduationSchoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year the student is expected to graduate."
          },
          "schoolYear": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with the student's enrollment."
          },
          "educationOrganizationNetworkSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Optional reference to the education organization network (e.g. charter network) the school belongs to for this enrollment. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "employedWhileEnrolled": {
            "type": "boolean",
            "description": "An individual who is a paid employee or works in his or her own business, profession, or farm and at the same time is enrolled in secondary, postsecondary, or adult education."
          },
          "fullTimeEquivalency": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "The full-time equivalent measure of a student's course load as a decimal."
          },
          "termCompletionIndicator": {
            "type": "boolean",
            "description": "Indicates whether the student completed the term."
          },
          "enrollmentTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of enrollment reflected by the StudentSchoolAssociation."
          },
          "nextYearGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The anticipated grade level for the student for the next school year."
          },
          "nextYearSchoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The anticipated school of enrollment for the student for the next school year."
          },
          "calendarCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar assigned to the student's school enrollment."
          },
          "alternativeGraduationPlans": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "graduationPlanTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of academic plan the student is following for this alternative graduation path."
                },
                "graduationSchoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "The school year the student is expected to graduate under this alternative plan."
                }
              },
              "required": [
                "graduationPlanTypeDescriptor",
                "graduationSchoolYear"
              ]
            },
            "description": "The secondary graduation plan or plans associated with the student enrolled in the school. A multi-valued collection child of StudentSchoolAssociation keyed by the parent's natural key plus the graduation plan type descriptor and graduation school year discriminators. Items unique by (graduationPlanTypeDescriptor, graduationSchoolYear)."
          },
          "educationPlans": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationPlanDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of education plan the student is following (e.g. IEP, 504 Plan, General Education)."
                }
              },
              "required": [
                "educationPlanDescriptor"
              ]
            },
            "description": "The type of education plan(s) the student is following, if appropriate. A multi-valued collection child of StudentSchoolAssociation keyed by the parent's natural key plus the education plan descriptor discriminator. Items unique by (educationPlanDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentSchoolAssociationRequest": {
        "type": "object",
        "description": "Update-StudentSchoolAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student enrolled in this school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the school enrolling the student.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "entryDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which an individual enters and begins to receive instructional services in a school."
          },
          "exitWithdrawDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year of the first day after the date of an individual's last attendance at a school (if known), the day on which an individual graduated, or the date on which it becomes known officially that an individual left school."
          },
          "primarySchool": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates if a given enrollment record should be considered the primary record for a student."
          },
          "entryGradeLevelDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The grade level or primary instructional level at which a student enters and receives services in a school or an educational institution during a given academic session."
          },
          "entryGradeLevelReasonDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The primary reason as to why a staff member determined that a student should be promoted or not (or be demoted) at the end of a given school term."
          },
          "entryTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The process by which a student enters a school during a given academic session."
          },
          "exitWithdrawTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The circumstances under which the student exited from membership in an educational institution."
          },
          "repeatGradeIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indicator of whether the student is enrolling to repeat a grade level, either by failure or an agreement to repeat."
          },
          "classOfSchoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1900,
            "maximum": 2100,
            "description": "Projected high school graduation year."
          },
          "schoolChoiceTransfer": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication of whether students transferred in or out of the school did so during the school year under the provisions for public school choice in accordance with Title I, Part A, Section 1116."
          },
          "schoolChoice": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An indication that the student transferred to the school under a school choice provision."
          },
          "schoolChoiceBasisDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The legal basis for the school choice enrollment according to local, state or federal policy or regulation."
          },
          "residencyStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the location of a persons legal residence relative to (within or outside of) the boundaries of the public school attended and its administrative unit."
          },
          "graduationPlanTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of academic plan the student is following for graduation."
          },
          "graduationSchoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year the student is expected to graduate."
          },
          "schoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1900,
            "maximum": 2100,
            "description": "The school year associated with the student's enrollment."
          },
          "educationOrganizationNetworkSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "description": "Optional reference to the education organization network (e.g. charter network) the school belongs to for this enrollment. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "employedWhileEnrolled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "An individual who is a paid employee or works in his or her own business, profession, or farm and at the same time is enrolled in secondary, postsecondary, or adult education."
          },
          "fullTimeEquivalency": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1,
            "description": "The full-time equivalent measure of a student's course load as a decimal."
          },
          "termCompletionIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student completed the term."
          },
          "enrollmentTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of enrollment reflected by the StudentSchoolAssociation."
          },
          "nextYearGradeLevelDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The anticipated grade level for the student for the next school year."
          },
          "nextYearSchoolSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "description": "The anticipated school of enrollment for the student for the next school year."
          },
          "calendarCode": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier for the calendar assigned to the student's school enrollment."
          },
          "alternativeGraduationPlans": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "graduationPlanTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of academic plan the student is following for this alternative graduation path."
                },
                "graduationSchoolYear": {
                  "type": "integer",
                  "minimum": 1900,
                  "maximum": 2100,
                  "description": "The school year the student is expected to graduate under this alternative plan."
                }
              },
              "required": [
                "graduationPlanTypeDescriptor",
                "graduationSchoolYear"
              ]
            },
            "description": "The secondary graduation plan or plans associated with the student enrolled in the school. A multi-valued collection child of StudentSchoolAssociation keyed by the parent's natural key plus the graduation plan type descriptor and graduation school year discriminators. Items unique by (graduationPlanTypeDescriptor, graduationSchoolYear)."
          },
          "educationPlans": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationPlanDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of education plan the student is following (e.g. IEP, 504 Plan, General Education)."
                }
              },
              "required": [
                "educationPlanDescriptor"
              ]
            },
            "description": "The type of education plan(s) the student is following, if appropriate. A multi-valued collection child of StudentSchoolAssociation keyed by the parent's natural key plus the education plan descriptor discriminator. Items unique by (educationPlanDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentSchoolAttendanceEventRequest": {
        "type": "object",
        "description": "Create-StudentSchoolAttendanceEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "eventDate",
          "sessionName",
          "attendanceEventCategoryDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose attendance is being recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the attendance event occurred.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The session (e.g., school day or period) for which attendance is recorded."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence, Tardy)."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "The reason for the attendance event, if applicable."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which the student was being educated at the time of the event (e.g., Classroom, Homebound)."
          },
          "eventDuration": {
            "type": "number",
            "description": "The amount of time for the event as decimal hours."
          },
          "schoolAttendanceDuration": {
            "type": "number",
            "description": "The duration of the school attendance event in decimal hours."
          },
          "arrivalTime": {
            "type": "string",
            "description": "The time of day the student arrived."
          },
          "departureTime": {
            "type": "string",
            "description": "The time of day the student departed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this attendance record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentSchoolAttendanceEventRequest": {
        "type": "object",
        "description": "Update-StudentSchoolAttendanceEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose attendance is being recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the attendance event occurred.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event."
          },
          "sessionName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The session (e.g., school day or period) for which attendance is recorded."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence, Tardy)."
          },
          "attendanceEventReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The reason for the attendance event, if applicable."
          },
          "educationalEnvironmentDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The setting in which the student was being educated at the time of the event (e.g., Classroom, Homebound)."
          },
          "eventDuration": {
            "type": [
              "number",
              "null"
            ],
            "description": "The amount of time for the event as decimal hours."
          },
          "schoolAttendanceDuration": {
            "type": [
              "number",
              "null"
            ],
            "description": "The duration of the school attendance event in decimal hours."
          },
          "arrivalTime": {
            "type": [
              "string",
              "null"
            ],
            "description": "The time of day the student arrived."
          },
          "departureTime": {
            "type": [
              "string",
              "null"
            ],
            "description": "The time of day the student departed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this attendance record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentSchoolFoodServiceProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentSchoolFoodServiceProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student enrolled in the food service program. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the food service program."
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the food service program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of food service program (e.g., National School Lunch Program, School Breakfast Program)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student began participating in the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student ended participation in the program."
          },
          "directCertification": {
            "type": "boolean",
            "description": "Indicates whether the student was directly certified for free meals without a household application."
          },
          "schoolFoodServiceProgramServiceDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The food service program service (e.g., Free Breakfast, Reduced Price Lunch, Full Price Breakfast)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this program association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentSchoolFoodServiceProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentSchoolFoodServiceProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student enrolled in the food service program. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The education organization providing the food service program."
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The name of the food service program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of food service program (e.g., National School Lunch Program, School Breakfast Program)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The date the student began participating in the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the student ended participation in the program."
          },
          "directCertification": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student was directly certified for free meals without a household application."
          },
          "schoolFoodServiceProgramServiceDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The food service program service (e.g., Free Breakfast, Reduced Price Lunch, Full Price Breakfast)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this program association record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentSection504ProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentSection504ProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState",
          "section504Eligibility"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "section504Eligibility": {
            "type": "boolean",
            "description": "Indicates whether student has a disability that qualifies student for Section 504 consideration. FALSE is equivalent to 'Did Not Qualify'."
          },
          "accommodationPlan": {
            "type": "boolean",
            "description": "Indicates whether student has a Section 504 accommodation plan."
          },
          "section504DisabilityDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Defines one or more disabilities student has that qualifies them for a Section 504 plan."
          },
          "section504MeetingDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the meeting with student's parent/guardian to discuss 504 eligibility."
          },
          "section504EligibilityDecisionDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the Section 504 eligibility decision is made."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentSection504ProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentSection504ProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "Program participation status history. Folded Common collection. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "section504Eligibility": {
            "type": "boolean",
            "description": "Indicates whether student has a disability that qualifies student for Section 504 consideration. FALSE is equivalent to 'Did Not Qualify'."
          },
          "accommodationPlan": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether student has a Section 504 accommodation plan."
          },
          "section504DisabilityDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Defines one or more disabilities student has that qualifies them for a Section 504 plan."
          },
          "section504MeetingDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date of the meeting with student's parent/guardian to discuss 504 eligibility."
          },
          "section504EligibilityDecisionDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date on which the Section 504 eligibility decision is made."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentSectionAssociationRequest": {
        "type": "object",
        "description": "Create-StudentSectionAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "classSourcedId",
          "schoolSourcedId",
          "beginDate",
          "role",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the student assigned to this section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "classSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the section (class) to which the student is assigned. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the school organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the student's entry or assignment to the section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the withdrawal or exit of the student from the section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "role": {
            "type": "string",
            "enum": [
              "student"
            ],
            "description": "RESTRICTED to the enrollment role \"student\" — only student enrollment rows are visible through this projection."
          },
          "homeroomIndicator": {
            "type": "boolean",
            "description": "Indicates the section is the student's homeroom. Homeroom period may be the convention for taking combined attendance in some schools."
          },
          "teacherStudentDataLinkExclusion": {
            "type": "boolean",
            "description": "Indicates that the student-teacher relationship should be excluded from calculations that rank teachers in student growth or performance measures."
          },
          "attemptStatusDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the student's completion status for the section."
          },
          "repeatIdentifierDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication as to whether a student has previously taken a given course (e.g., Repeated, Not Repeated, Replacement)."
          },
          "programs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster sourcedId of the education organization that owns the program. References `oneroster:org.sourcedId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Bilingual, Special Education, Career and Technical Education)."
                }
              },
              "required": [
                "educationOrganizationSourcedId",
                "programName",
                "programTypeDescriptor"
              ]
            },
            "description": "The program(s) associated with a student's section enrollment. Items unique by (educationOrganizationSourcedId, programName, programTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentSectionAssociationRequest": {
        "type": "object",
        "description": "Update-StudentSectionAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the student assigned to this section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "classSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the section (class) to which the student is assigned. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 256,
            "description": "The OneRoster sourcedId of the school organization. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "Month, day, and year of the student's entry or assignment to the section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Month, day, and year of the withdrawal or exit of the student from the section. Shared roster field — UPDATE requires edfi:write-shared."
          },
          "role": {
            "type": "string",
            "enum": [
              "student"
            ],
            "description": "RESTRICTED to the enrollment role \"student\" — only student enrollment rows are visible through this projection."
          },
          "homeroomIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates the section is the student's homeroom. Homeroom period may be the convention for taking combined attendance in some schools."
          },
          "teacherStudentDataLinkExclusion": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates that the student-teacher relationship should be excluded from calculations that rank teachers in student growth or performance measures."
          },
          "attemptStatusDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the student's completion status for the section."
          },
          "repeatIdentifierDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication as to whether a student has previously taken a given course (e.g., Repeated, Not Repeated, Replacement)."
          },
          "programs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "educationOrganizationSourcedId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "description": "The OneRoster sourcedId of the education organization that owns the program. References `oneroster:org.sourcedId`; validated at the command layer (parent write hook) — the schema-level FK does not survive the jsonb fold."
                },
                "programName": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The formal name of the program of instruction, training, services, or benefits available through federal, state, or local agencies."
                },
                "programTypeDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The type of program (e.g., Bilingual, Special Education, Career and Technical Education)."
                }
              },
              "required": [
                "educationOrganizationSourcedId",
                "programName",
                "programTypeDescriptor"
              ]
            },
            "description": "The program(s) associated with a student's section enrollment. Items unique by (educationOrganizationSourcedId, programName, programTypeDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentSectionAttendanceEventRequest": {
        "type": "object",
        "description": "Create-StudentSectionAttendanceEvent request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "classSourcedId",
          "eventDate",
          "attendanceEventCategoryDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose section attendance is being recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the section attendance event occurred.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The class (section) for which attendance is being recorded. Projects to the Alpha attendanceEvent's section reference.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event. Projects to the Alpha attendanceEvent's eventDate."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence, Tardy). This field projects to the Alpha attendanceEvent's category field."
          },
          "sectionIdentifier": {
            "type": "string",
            "maxLength": 255,
            "description": "The local identifier assigned to the section, providing a descriptive link."
          },
          "localCourseCode": {
            "type": "string",
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year."
          },
          "termDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "attendanceEventReason": {
            "type": "string",
            "maxLength": 255,
            "description": "The reason for the attendance event, if applicable."
          },
          "educationalEnvironmentDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The setting in which the student was being educated at the time of the event (e.g., Classroom, Homebound)."
          },
          "eventDuration": {
            "type": "number",
            "description": "The amount of time for the event as decimal hours."
          },
          "sectionAttendanceDuration": {
            "type": "number",
            "description": "The duration of the section attendance event in decimal hours."
          },
          "arrivalTime": {
            "type": "string",
            "description": "The time of day the student arrived."
          },
          "departureTime": {
            "type": "string",
            "description": "The time of day the student departed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this attendance record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentSectionAttendanceEventRequest": {
        "type": "object",
        "description": "Update-StudentSectionAttendanceEvent request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose section attendance is being recorded.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school where the section attendance event occurred.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The class (section) for which attendance is being recorded. Projects to the Alpha attendanceEvent's section reference.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "eventDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the attendance event. Projects to the Alpha attendanceEvent's eventDate."
          },
          "attendanceEventCategoryDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The category of attendance event (e.g., In Attendance, Excused Absence, Unexcused Absence, Tardy). This field projects to the Alpha attendanceEvent's category field."
          },
          "sectionIdentifier": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The local identifier assigned to the section, providing a descriptive link."
          },
          "localCourseCode": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The local code assigned by the school that identifies the course offering."
          },
          "schoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The school year."
          },
          "termDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The term (e.g., Fall Semester)."
          },
          "attendanceEventReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The reason for the attendance event, if applicable."
          },
          "educationalEnvironmentDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The setting in which the student was being educated at the time of the event (e.g., Classroom, Homebound)."
          },
          "eventDuration": {
            "type": [
              "number",
              "null"
            ],
            "description": "The amount of time for the event as decimal hours."
          },
          "sectionAttendanceDuration": {
            "type": [
              "number",
              "null"
            ],
            "description": "The duration of the section attendance event in decimal hours."
          },
          "arrivalTime": {
            "type": [
              "string",
              "null"
            ],
            "description": "The time of day the student arrived."
          },
          "departureTime": {
            "type": [
              "string",
              "null"
            ],
            "description": "The time of day the student departed."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this attendance record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentSpecialEducationProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentSpecialEducationProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the special education program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the special education program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (Special Education)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "ideaEligibility": {
            "type": "boolean",
            "description": "Indicator of the eligibility of the student to receive special education services according to the Individuals with Disabilities Education Act (IDEA)."
          },
          "specialEducationSettingDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The major instructional setting (more than 50 percent of a student's special education program)."
          },
          "specialEducationHoursPerWeek": {
            "type": "number",
            "minimum": 0,
            "description": "The number of hours per week for special education instruction and target services."
          },
          "schoolHoursPerWeek": {
            "type": "number",
            "minimum": 0,
            "description": "The number of hours per week the student attends school."
          },
          "multiplyDisabled": {
            "type": "boolean",
            "description": "Indicates whether the student receiving special education and related services has been designated as multiply disabled by the admission, review, and dismissal committee as appropriate."
          },
          "medicallyFragile": {
            "type": "boolean",
            "description": "Indicates whether the student receiving special education and related services is medically fragile — a chronic illness."
          },
          "lastEvaluationDate": {
            "type": "string",
            "format": "date",
            "description": "The date of the last special education evaluation."
          },
          "iepBeginDate": {
            "type": "string",
            "format": "date",
            "description": "The effective date of the current Individualized Education Program (IEP)."
          },
          "iepEndDate": {
            "type": "string",
            "format": "date",
            "description": "The end date of the current Individualized Education Program (IEP)."
          },
          "iepReviewDate": {
            "type": "string",
            "format": "date",
            "description": "The date the IEP was last reviewed."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's special education program participation over time. A multi-valued collection child of studentSpecialEducationProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "specialEducationProgramServices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "specialEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the special education program (e.g., speech therapy, occupational therapy, physical therapy)."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this option for the current school year."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this option for the current school year."
                }
              },
              "required": [
                "specialEducationProgramServiceDescriptor"
              ]
            },
            "description": "Indicates the service(s) being provided to the student by the special education program. A multi-valued collection child of studentSpecialEducationProgramAssociation keyed by the parent's 5-column natural key plus the specialEducationProgramServiceDescriptor discriminator. Items unique by (specialEducationProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentSpecialEducationProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentSpecialEducationProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the special education program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the special education program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (Special Education)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "ideaEligibility": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicator of the eligibility of the student to receive special education services according to the Individuals with Disabilities Education Act (IDEA)."
          },
          "specialEducationSettingDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The major instructional setting (more than 50 percent of a student's special education program)."
          },
          "specialEducationHoursPerWeek": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "description": "The number of hours per week for special education instruction and target services."
          },
          "schoolHoursPerWeek": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "description": "The number of hours per week the student attends school."
          },
          "multiplyDisabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student receiving special education and related services has been designated as multiply disabled by the admission, review, and dismissal committee as appropriate."
          },
          "medicallyFragile": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student receiving special education and related services is medically fragile — a chronic illness."
          },
          "lastEvaluationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date of the last special education evaluation."
          },
          "iepBeginDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The effective date of the current Individualized Education Program (IEP)."
          },
          "iepEndDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The end date of the current Individualized Education Program (IEP)."
          },
          "iepReviewDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date the IEP was last reviewed."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's special education program participation over time. A multi-valued collection child of studentSpecialEducationProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "specialEducationProgramServices": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "specialEducationProgramServiceDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "Indicates the service being provided to the student by the special education program (e.g., speech therapy, occupational therapy, physical therapy)."
                },
                "primaryIndicator": {
                  "type": "boolean",
                  "description": "True if service is primary."
                },
                "serviceBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "First date the student was in this option for the current school year."
                },
                "serviceEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "Last date the student was in this option for the current school year."
                }
              },
              "required": [
                "specialEducationProgramServiceDescriptor"
              ]
            },
            "description": "Indicates the service(s) being provided to the student by the special education program. A multi-valued collection child of studentSpecialEducationProgramAssociation keyed by the parent's 5-column natural key plus the specialEducationProgramServiceDescriptor discriminator. Items unique by (specialEducationProgramServiceDescriptor)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentSpecialEducationProgramEligibilityAssociationRequest": {
        "type": "object",
        "description": "Create-StudentSpecialEducationProgramEligibilityAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "educationOrganizationSourcedId",
          "studentSourcedId",
          "programEducationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "consentToEvaluationReceivedDate",
          "ideaPartDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization where the student was evaluated for special education services.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student who is evaluated by a local education agency or a school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the program being evaluated for (program natural-key leg).",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program being evaluated for."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the program being evaluated for."
          },
          "consentToEvaluationReceivedDate": {
            "type": "string",
            "format": "date",
            "description": "Date on which the LEA received written consent for the evaluation from the student's parent."
          },
          "originalECIServicesDate": {
            "type": "string",
            "format": "date",
            "description": "Date when an infant or toddler began participating in early childhood intervention services."
          },
          "ideaPartDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Indicates if the evaluation is done under Part B IDEA or Part C IDEA."
          },
          "consentToEvaluationDate": {
            "type": "string",
            "format": "date",
            "description": "The date on which the student's parent gave consent (Parent Consent Date)."
          },
          "evaluationCompleteIndicator": {
            "type": "boolean",
            "description": "Indicates the evaluation completed status."
          },
          "eligibilityEvaluationDate": {
            "type": "string",
            "format": "date",
            "description": "Date when the written individual evaluation report was completed."
          },
          "eligibilityEvaluationTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Indicates if this is an initial evaluation or a reevaluation."
          },
          "evaluationDelayReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Justification as to why the evaluation report was completed beyond the state-established timeframe."
          },
          "evaluationLateReason": {
            "type": "string",
            "maxLength": 255,
            "description": "Additional information for delay in doing the evaluation."
          },
          "evaluationDelayDays": {
            "type": "integer",
            "description": "Number of student absences contributing to evaluation delay."
          },
          "eligibilityDeterminationDate": {
            "type": "string",
            "format": "date",
            "description": "Date the LEA held the ARD committee meeting regarding eligibility."
          },
          "ideaIndicator": {
            "type": "boolean",
            "description": "Indicates whether or not the student was determined eligible as a result of an evaluation."
          },
          "eligibilityDelayReasonDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The reason why the eligibility determination was completed beyond the required timeframe."
          },
          "transitionNotificationDate": {
            "type": "string",
            "format": "date",
            "description": "Date the LEA Notification of Potentially Eligible for Special Education Services was sent."
          },
          "transitionConferenceDate": {
            "type": "string",
            "format": "date",
            "description": "Date when the transition conference was held."
          },
          "eligibilityConferenceDate": {
            "type": "string",
            "format": "date",
            "description": "Date when the eligibility conference is held between parent(s)/guardian(s) and the educational organization."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentSpecialEducationProgramEligibilityAssociationRequest": {
        "type": "object",
        "description": "Update-StudentSpecialEducationProgramEligibilityAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization where the student was evaluated for special education services.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Student who is evaluated by a local education agency or a school.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization of the program being evaluated for (program natural-key leg).",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the program being evaluated for."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of the program being evaluated for."
          },
          "consentToEvaluationReceivedDate": {
            "type": "string",
            "format": "date",
            "description": "Date on which the LEA received written consent for the evaluation from the student's parent."
          },
          "originalECIServicesDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date when an infant or toddler began participating in early childhood intervention services."
          },
          "ideaPartDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Indicates if the evaluation is done under Part B IDEA or Part C IDEA."
          },
          "consentToEvaluationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The date on which the student's parent gave consent (Parent Consent Date)."
          },
          "evaluationCompleteIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates the evaluation completed status."
          },
          "eligibilityEvaluationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date when the written individual evaluation report was completed."
          },
          "eligibilityEvaluationTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Indicates if this is an initial evaluation or a reevaluation."
          },
          "evaluationDelayReasonDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Justification as to why the evaluation report was completed beyond the state-established timeframe."
          },
          "evaluationLateReason": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "Additional information for delay in doing the evaluation."
          },
          "evaluationDelayDays": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of student absences contributing to evaluation delay."
          },
          "eligibilityDeterminationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date the LEA held the ARD committee meeting regarding eligibility."
          },
          "ideaIndicator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether or not the student was determined eligible as a result of an evaluation."
          },
          "eligibilityDelayReasonDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The reason why the eligibility determination was completed beyond the required timeframe."
          },
          "transitionNotificationDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date the LEA Notification of Potentially Eligible for Special Education Services was sent."
          },
          "transitionConferenceDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date when the transition conference was held."
          },
          "eligibilityConferenceDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date when the eligibility conference is held between parent(s)/guardian(s) and the educational organization."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentTitleIPartAProgramAssociationRequest": {
        "type": "object",
        "description": "Create-StudentTitleIPartAProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "programEducationOrganizationSourcedId",
          "programName",
          "programTypeDescriptor",
          "beginDate",
          "titleIPartAParticipantDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the Title I Part A program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the Title I Part A program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (Title I Part A)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": "boolean",
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "titleIPartAParticipantDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the type of Title I program, if any, in which the student is participating and by which the student is served (e.g., Public Targeted Assistance Program, Public Schoolwide Program, Private School Students Participating)."
          },
          "programParticipationStatuses": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's Title I Part A program participation over time. A multi-valued collection child of studentTitleIPartAProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentTitleIPartAProgramAssociationRequest": {
        "type": "object",
        "description": "Update-StudentTitleIPartAProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the student in the Title I Part A program. Roster FK leg to the user entity.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "programEducationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster sourcedId of the education organization operating the program. Roster FK leg to the org entity.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The formal name of the Title I Part A program."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The type of program (Title I Part A)."
          },
          "beginDate": {
            "type": "string",
            "format": "date",
            "description": "The earliest date the student is involved with the program."
          },
          "endDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "The month, day, and year on which the student exited the program or stopped receiving services."
          },
          "reasonExitedDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 306,
            "description": "The reason the student left the program within a school or district."
          },
          "servedOutsideOfRegularSession": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether the student received services during the summer session or between sessions."
          },
          "titleIPartAParticipantDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "An indication of the type of Title I program, if any, in which the student is participating and by which the student is served (e.g., Public Targeted Assistance Program, Public Schoolwide Program, Private School Students Participating)."
          },
          "programParticipationStatuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "participationStatusDescriptor": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 306,
                  "description": "The student's program participation status."
                },
                "statusBeginDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status became effective."
                },
                "statusEndDate": {
                  "type": "string",
                  "format": "date",
                  "description": "The date the participation status ended."
                },
                "designatedBy": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 60,
                  "description": "The person, organization, or department that designated the participation status."
                }
              },
              "required": [
                "participationStatusDescriptor",
                "statusBeginDate"
              ]
            },
            "description": "The status of a student's Title I Part A program participation over time. A multi-valued collection child of studentTitleIPartAProgramAssociation keyed by the parent's 5-column natural key plus the status descriptor and status begin date discriminators. Items unique by (participationStatusDescriptor, statusBeginDate)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateStudentTransportationRequest": {
        "type": "object",
        "description": "Create-StudentTransportation request body (readOnly/server-managed fields excluded).",
        "required": [
          "studentSourcedId",
          "schoolSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose transportation is recorded. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school the student is transported to/from. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "amTransportation": {
            "type": "string",
            "maxLength": 60,
            "description": "The transportation mode for the morning commute (e.g., Bus, Walk, Parent Transport)."
          },
          "pmTransportation": {
            "type": "string",
            "maxLength": 60,
            "description": "The transportation mode for the afternoon commute (e.g., Bus, Walk, Parent Transport)."
          },
          "transportationPublicExpenseEligibilityTypeDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "Eligibility type for transportation at public expense (e.g., Eligible, Not Eligible)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student transportation record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateStudentTransportationRequest": {
        "type": "object",
        "description": "Update-StudentTransportation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "studentSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The student whose transportation is recorded. Cross-module roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "schoolSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The school the student is transported to/from. Cross-module roster FK to oneroster:org.sourcedId.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "amTransportation": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The transportation mode for the morning commute (e.g., Bus, Walk, Parent Transport)."
          },
          "pmTransportation": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The transportation mode for the afternoon commute (e.g., Bus, Walk, Parent Transport)."
          },
          "transportationPublicExpenseEligibilityTypeDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "Eligibility type for transportation at public expense (e.g., Eligible, Not Eligible)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this student transportation record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyRequest": {
        "type": "object",
        "description": "Create-Survey request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the survey."
          },
          "surveyTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the survey."
          },
          "sessionName": {
            "type": "string",
            "maxLength": 60,
            "description": "The session during which the survey was administered."
          },
          "schoolYear": {
            "type": "integer",
            "description": "The school year during which the survey was administered."
          },
          "schoolSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school associated with this survey.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "surveyCategoryDescriptor": {
            "type": "string",
            "maxLength": 306,
            "description": "The category of the survey."
          },
          "numberAdministered": {
            "type": "integer",
            "description": "The number of people to whom the survey was administered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyRequest": {
        "type": "object",
        "description": "Update-Survey request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique number or alphanumeric code assigned to the survey."
          },
          "surveyTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the survey."
          },
          "sessionName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 60,
            "description": "The session during which the survey was administered."
          },
          "schoolYear": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The school year during which the survey was administered."
          },
          "schoolSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The OneRoster org sourcedId identifying the school associated with this survey.",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "surveyCategoryDescriptor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 306,
            "description": "The category of the survey."
          },
          "numberAdministered": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The number of people to whom the survey was administered."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyCourseAssociationRequest": {
        "type": "object",
        "description": "Create-SurveyCourseAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "educationOrganizationId",
          "courseCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization that owns the course (roster org).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Course code within the education organization. Paired with educationOrganizationId; validated at the command layer against oneroster:course (projections cannot back FKs)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyCourseAssociationRequest": {
        "type": "object",
        "description": "Update-SurveyCourseAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization that owns the course (roster org).",
            "x-references": "oneroster:org.sourcedId",
            "x-onDelete": "restrict"
          },
          "courseCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Course code within the education organization. Paired with educationOrganizationId; validated at the command layer against oneroster:course (projections cannot back FKs)."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyProgramAssociationRequest": {
        "type": "object",
        "description": "Create-SurveyProgramAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "educationOrganizationId",
          "programName",
          "programTypeDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization that owns the program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Program type."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyProgramAssociationRequest": {
        "type": "object",
        "description": "Update-SurveyProgramAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization that owns the program.",
            "x-references": "program.educationOrganizationId",
            "x-references-legs": [
              "programName",
              "programTypeDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "programName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Program name."
          },
          "programTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Program type."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyQuestionRequest": {
        "type": "object",
        "description": "Create-SurveyQuestion request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "questionCode",
          "questionFormDescriptor",
          "questionText",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "questionCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code identifying this question within the survey."
          },
          "questionFormDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The form or type of the question (e.g., multiple choice, free response, Likert scale)."
          },
          "questionText": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "The text of the survey question as presented to respondents."
          },
          "surveySectionTitle": {
            "type": "string",
            "maxLength": 255,
            "description": "The title of the survey section to which this question belongs."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey question record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyQuestionRequest": {
        "type": "object",
        "description": "Update-SurveyQuestion request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "questionCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique code identifying this question within the survey."
          },
          "questionFormDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "The form or type of the question (e.g., multiple choice, free response, Likert scale)."
          },
          "questionText": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024,
            "description": "The text of the survey question as presented to respondents."
          },
          "surveySectionTitle": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The title of the survey section to which this question belongs."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey question record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyQuestionResponseRequest": {
        "type": "object",
        "description": "Create-SurveyQuestionResponse request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "questionCode",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "questionCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The code identifying the question being answered."
          },
          "noResponse": {
            "type": "boolean",
            "description": "Indicates that the respondent did not provide a response to this question."
          },
          "comment": {
            "type": "string",
            "maxLength": 1024,
            "description": "A comment or additional text provided with the response."
          },
          "numericResponse": {
            "type": "integer",
            "description": "A numeric value provided as the response."
          },
          "textResponse": {
            "type": "string",
            "maxLength": 2048,
            "description": "A free-text response provided by the respondent."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey question response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyQuestionResponseRequest": {
        "type": "object",
        "description": "Update-SurveyQuestionResponse request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "questionCode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The code identifying the question being answered."
          },
          "noResponse": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates that the respondent did not provide a response to this question."
          },
          "comment": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "A comment or additional text provided with the response."
          },
          "numericResponse": {
            "type": [
              "integer",
              "null"
            ],
            "description": "A numeric value provided as the response."
          },
          "textResponse": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "A free-text response provided by the respondent."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey question response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyResponseRequest": {
        "type": "object",
        "description": "Create-SurveyResponse request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "responseDate",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for this particular survey response."
          },
          "responseDate": {
            "type": "string",
            "format": "date",
            "description": "The date the survey response was submitted."
          },
          "electronicMailAddress": {
            "type": "string",
            "maxLength": 128,
            "description": "The electronic mail address of the respondent."
          },
          "studentSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who responded to this survey (OneRoster roster identity boundary). Optional because surveys can be anonymous.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffSourcedId": {
            "type": "string",
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member who responded to this survey (OneRoster roster identity boundary). Optional because surveys can be anonymous.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyResponseRequest": {
        "type": "object",
        "description": "Update-SurveyResponse request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for this particular survey response."
          },
          "responseDate": {
            "type": "string",
            "format": "date",
            "description": "The date the survey response was submitted."
          },
          "electronicMailAddress": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128,
            "description": "The electronic mail address of the respondent."
          },
          "studentSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the student who responded to this survey (OneRoster roster identity boundary). Optional because surveys can be anonymous.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "staffSourcedId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255,
            "description": "The OneRoster user sourcedId identifying the staff member who responded to this survey (OneRoster roster identity boundary). Optional because surveys can be anonymous.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyResponseEducationOrganizationTargetAssociationRequest": {
        "type": "object",
        "description": "Create-SurveyResponseEducationOrganizationTargetAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "educationOrganizationId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the education organization targeted by this survey response."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyResponseEducationOrganizationTargetAssociationRequest": {
        "type": "object",
        "description": "Update-SurveyResponseEducationOrganizationTargetAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the education organization targeted by this survey response."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyResponsePersonTargetAssociationRequest": {
        "type": "object",
        "description": "Create-SurveyResponsePersonTargetAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "personId",
          "sourceSystemDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey response.",
            "x-references": "surveyResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who is the target of the survey response.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyResponsePersonTargetAssociationRequest": {
        "type": "object",
        "description": "Update-SurveyResponsePersonTargetAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey response.",
            "x-references": "surveyResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who is the target of the survey response.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveyResponseStaffTargetAssociationRequest": {
        "type": "object",
        "description": "Create-SurveyResponseStaffTargetAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "staffSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey response.",
            "x-references": "surveyResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Staff member who is the target of the survey response. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveyResponseStaffTargetAssociationRequest": {
        "type": "object",
        "description": "Update-SurveyResponseStaffTargetAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey response.",
            "x-references": "surveyResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Staff member who is the target of the survey response. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveySectionRequest": {
        "type": "object",
        "description": "Create-SurveySection request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveySectionTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the survey section."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey section record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveySectionRequest": {
        "type": "object",
        "description": "Update-SurveySection request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title or name of the survey section."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey section record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveySectionAggregateResponseRequest": {
        "type": "object",
        "description": "Create-SurveySectionAggregateResponse request body (readOnly/server-managed fields excluded).",
        "required": [
          "personId",
          "sourceSystemDescriptor",
          "educationOrganizationSourcedId",
          "evaluationPeriodDescriptor",
          "performanceEvaluationTitle",
          "performanceEvaluationTypeDescriptor",
          "schoolYear",
          "termDescriptor",
          "evaluationTitle",
          "evaluationDate",
          "evaluationObjectiveTitle",
          "evaluationElementTitle",
          "namespace",
          "surveyIdentifier",
          "surveySectionTitle",
          "scoreValue",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation element rating.",
            "x-references": "evaluationElementRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey namespace.",
            "x-references": "surveySection.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Survey section title."
          },
          "scoreValue": {
            "type": "number",
            "description": "Aggregate score value."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveySectionAggregateResponseRequest": {
        "type": "object",
        "description": "Update-SurveySectionAggregateResponse request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person of the parent evaluation element rating.",
            "x-references": "evaluationElementRating.personId",
            "x-references-legs": [
              "sourceSystemDescriptor",
              "educationOrganizationSourcedId",
              "evaluationPeriodDescriptor",
              "performanceEvaluationTitle",
              "performanceEvaluationTypeDescriptor",
              "schoolYear",
              "termDescriptor",
              "evaluationTitle",
              "evaluationDate",
              "evaluationObjectiveTitle",
              "evaluationElementTitle"
            ],
            "x-onDelete": "cascade"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "educationOrganizationSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Education organization."
          },
          "evaluationPeriodDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Evaluation period."
          },
          "performanceEvaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Performance evaluation title."
          },
          "performanceEvaluationTypeDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Performance evaluation type."
          },
          "schoolYear": {
            "type": "integer",
            "description": "School year."
          },
          "termDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Term."
          },
          "evaluationTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation title."
          },
          "evaluationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Evaluation rating date/time."
          },
          "evaluationObjectiveTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Evaluation objective title."
          },
          "evaluationElementTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Evaluation element title."
          },
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey namespace.",
            "x-references": "surveySection.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Survey section title."
          },
          "scoreValue": {
            "type": "number",
            "description": "Aggregate score value."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveySectionAssociationRequest": {
        "type": "object",
        "description": "Create-SurveySectionAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "classSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster class sourcedId identifying the section associated with the survey.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveySectionAssociationRequest": {
        "type": "object",
        "description": "Update-SurveySectionAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey.",
            "x-references": "survey.namespace",
            "x-references-legs": [
              "surveyIdentifier"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "classSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The OneRoster class sourcedId identifying the section associated with the survey.",
            "x-references": "oneroster:class.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveySectionResponseRequest": {
        "type": "object",
        "description": "Create-SurveySectionResponse request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "surveySectionTitle",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title of the survey section being responded to."
          },
          "sectionRating": {
            "type": "number",
            "description": "A numeric rating for this section provided by the respondent."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey section response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveySectionResponseRequest": {
        "type": "object",
        "description": "Update-SurveySectionResponse request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title of the survey section being responded to."
          },
          "sectionRating": {
            "type": [
              "number",
              "null"
            ],
            "description": "A numeric rating for this section provided by the respondent."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this survey section response record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveySectionResponseEducationOrganizationTargetAssociationRequest": {
        "type": "object",
        "description": "Create-SurveySectionResponseEducationOrganizationTargetAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "surveySectionTitle",
          "educationOrganizationId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title of the survey section being responded to."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the education organization targeted by this survey section response."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveySectionResponseEducationOrganizationTargetAssociationRequest": {
        "type": "object",
        "description": "Update-SurveySectionResponseEducationOrganizationTargetAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace for the survey, typically a URI identifying the owning organization."
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The unique identifier of the parent survey."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "A unique identifier for the parent survey response."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "The title of the survey section being responded to."
          },
          "educationOrganizationId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "The identifier of the education organization targeted by this survey section response."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this association record. Records are typically canonical on creation; soft_deleted when removed via DELETE.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveySectionResponsePersonTargetAssociationRequest": {
        "type": "object",
        "description": "Create-SurveySectionResponsePersonTargetAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "surveySectionTitle",
          "personId",
          "sourceSystemDescriptor",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey section response.",
            "x-references": "surveySectionResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey section title."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who is the target of the survey section response.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveySectionResponsePersonTargetAssociationRequest": {
        "type": "object",
        "description": "Update-SurveySectionResponsePersonTargetAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey section response.",
            "x-references": "surveySectionResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey section title."
          },
          "personId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "description": "Person who is the target of the survey section response.",
            "x-references": "person.personId",
            "x-references-legs": [
              "sourceSystemDescriptor"
            ],
            "x-onDelete": "restrict"
          },
          "sourceSystemDescriptor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 306,
            "description": "Source system of the person."
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "CreateSurveySectionResponseStaffTargetAssociationRequest": {
        "type": "object",
        "description": "Create-SurveySectionResponseStaffTargetAssociation request body (readOnly/server-managed fields excluded).",
        "required": [
          "namespace",
          "surveyIdentifier",
          "surveyResponseIdentifier",
          "surveySectionTitle",
          "staffSourcedId",
          "recordState"
        ],
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey section response.",
            "x-references": "surveySectionResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey section title."
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Staff member who is the target of the survey section response. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": "string",
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy"
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "UpdateSurveySectionResponseStaffTargetAssociationRequest": {
        "type": "object",
        "description": "Update-SurveySectionResponseStaffTargetAssociation request body (partial — all fields optional; readOnly + immutable fields excluded; null clears a nullable column).",
        "additionalProperties": false,
        "properties": {
          "namespace": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Namespace of the survey section response.",
            "x-references": "surveySectionResponse.namespace",
            "x-references-legs": [
              "surveyIdentifier",
              "surveyResponseIdentifier",
              "surveySectionTitle"
            ],
            "x-onDelete": "restrict"
          },
          "surveyIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey identifier."
          },
          "surveyResponseIdentifier": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Survey response identifier."
          },
          "surveySectionTitle": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Survey section title."
          },
          "staffSourcedId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "description": "Staff member who is the target of the survey section response. Roster FK to oneroster:user.sourcedId.",
            "x-references": "oneroster:user.sourcedId",
            "x-onDelete": "restrict"
          },
          "recordState": {
            "type": "string",
            "enum": [
              "draft",
              "canonical",
              "rejected",
              "soft_deleted"
            ],
            "description": "Lifecycle state of this record.",
            "default": "canonical"
          },
          "deleteSource": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "api",
              "import",
              "correction",
              "retention_policy",
              null
            ],
            "description": "The origin of the soft-delete action when this record is deleted."
          }
        }
      },
      "Problem": {
        "type": "object",
        "description": "RFC 7807 problem details.",
        "properties": {
          "type": {
            "type": "string",
            "format": "uri",
            "description": "A URI identifying the problem type."
          },
          "title": {
            "type": "string",
            "description": "A short, human-readable summary of the problem."
          },
          "status": {
            "type": "integer",
            "description": "The HTTP status code."
          },
          "detail": {
            "type": "string",
            "description": "A human-readable explanation specific to this occurrence."
          },
          "instance": {
            "type": "string",
            "format": "uri",
            "description": "A URI identifying this occurrence."
          }
        },
        "required": [
          "title",
          "status"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "servers": [
    {
      "url": "https://edfi.platform4.alphaschool.dev"
    }
  ]
}