Bruke mutations i Utdanningsregister API

Mutations brukes for å rapportere og oppdatere utdanningsdata i Utdanningsregisteret.

Forutsetninger

Denne guiden forutsetter at du har gjennomført Skaffe tilgang og har et gyldig Maskinporten-token.

Autentisering

Nødvendig scope

Mutations krever alltid autentisering med write-scope:

sikt:utdanningsregisteret/utdanning.write

Write-scope inkluderer lesetilgang

Du trenger ikke separate tokens for queries og mutations.

Oversikt over mutations

Kategori	Beskrivelse
Organisasjon	Endre organisasjoner
Campus og Lærested	Opprett og endre campuser og læresteder
Utdanningsspesifikasjon	Opprett og endre utdanningsbeskrivelser
Utdanningsmulighet	Opprett og endre utdanningstilbud
Utdanningsinstans	Opprett og endre konkrete gjennomføringer
Akkreditering	Registrer akkrediteringer

Feilhåndtering i eksempler

Eksemplene nedenfor viser kun essensielle felter i responsen for klarhet. Alle mutations returnerer også errors-felt for validering - se Feilhåndtering for detaljer.

Grunnleggende eksempler

Opprett utdanningsspesifikasjon

mutation OpprettStudieprogram {
  opprettUtdanningsspesifikasjon(
    input: {
      organisasjonskode: "1234"
      kode: "BINF-OSLO"
      originalnavn: "Bachelor i Zoologi"
      typekode: "STUDIEPROGRAM"
      statuskode: "AKTIV"
      utdanningsniva: {
        nuskode: "651101"
        nkrkode: "6.2"
      }
      datasystemkodeKilde: "FS"
    }
  ) {
    utdanningsspesifikasjon {
      id
      kode
      originalnavn
    }
  }
}

Opprett utdanningsmulighet

mutation OpprettUtdanningsmulighet {
  opprettUtdanningsmulighet(
    input: {
      utdanningsspesifikasjonsId: "VXRkYW5uaW5nc3NwZXNpZmlrYXNqb246MTIzNDU2"
      organisasjonskode: "1234"
      kode: "BINF-OSLO"
      statuskode: "AKTIV"
      datasystemkodeKilde: "FS"
      undervisningssprakkode: "nob"
      prosenttallHeltid: 100
    }
  ) {
    utdanningsmulighet {
      id
      kode
    }
  }
}

Opprett utdanningsinstans

mutation OpprettInstans {
  opprettUtdanningsinstans(
    input: {
      utdanningsmulighetId: "VXRkYW5uaW5nc211bGlnaGV0OjEyMzQ1Ng=="
      organisasjonskode: "1234"
      kode: "BINF-H2025"
      originalnavn: "Bachelor i informatikk - Høst 2025"
      organiseringskode: "CAMPUS"
      statuskode: "AKTIV"
      datasystemkodeKilde: "FS"
      fraTermin: {
        fraArstall: 2025
        frakode: "HØST"
      }
      tilTermin: {
        tilArstall: 2028
        tilkode: "VÅR"
      }
    }
  ) {
    utdanningsinstans {
      id
      kode
      originalnavn
    }
  }
}

Endre organisasjonsnavn

mutation EndreOrganisasjonsnavn {
  endreOrganisasjonsnavn(
    input: {
      organisasjonId: "T3JnYW5pc2Fzam9uOjEyMzQ1Ng=="
      sprakkode: "nob"
      navn: "Nytt Universitetnavn"
      navnForkortelse: "NyU"
      periode: {
        fraDato: "2025-08-01"
      }
    }
  ) {
    navn {
      navn
      navnForkortelse
    }
  }
}

Historikk

Eksempler på mutasjoner som bevarer historikk:

• endreOrganisasjonsnavn
• endreUtdanningsspesifikasjonsnavn
• endreUtdanningsmulighetstatus
• endreUtdanningsinstansnavn
• endreUtdanningsinstansstatus

Feilhåndtering

Alle mutations returnerer errors-felt for validering og forretningslogikk-feil:

mutation {
  opprettUtdanningsspesifikasjon(input: {...}) {
    utdanningsspesifikasjon {
      id
    }
    errors {
      ... on UtdanningsregisterUgyldigInput {
        message
        path
      }
    }
  }
}