Modeller¶

Denne side beskriver de datamodeller (DTO'er), der bruges i request- og response-bodies.

Organisation¶

OrganisationResponse¶

Returneres ved GET /v1/organisation og PUT /v1/organisation.

Felt	Type	Beskrivelse
`organisation_id`	string (UUID)	Organisationens unikke ID
`group_id`	string (UUID)	Rod-gruppens ID
`name`	string	Organisationens navn
`group`	Group	Rod-gruppe-objekt

OrganisationUpdateRequest¶

Request body ved PUT /v1/organisation.

Felt	Type	Påkrævet	Beskrivelse
`organisation_id`	string (UUID)	Ja	Organisationens ID (skal matche JWT)
`name`	string	Ja	Nyt organisationsnavn

Grupper¶

Group¶

Standardrepræsentation af en gruppe.

Felt	Type	Beskrivelse
`id`	string (UUID)	Gruppens unikke ID
`name`	string	Gruppenavn
`parent_id`	string (UUID) \| null	Forældregruppens ID (`null` for rod)

GroupTree¶

Udvidet gruppe med børn — returneres ved GET /v1/groups/{id}/tree.

Felt	Type	Beskrivelse
`id`	string (UUID)	Gruppens unikke ID
`name`	string	Gruppenavn
`parent_id`	string (UUID) \| null	Forældregruppens ID
`children`	GroupTree[]	Rekursiv liste af undergrupper

Minimal mode

Med ?minimal=true returneres kun id, name og children for at reducere payload-størrelse.

GroupCreateRequest¶

Request body ved POST /v1/groups.

Felt	Type	Påkrævet	Beskrivelse
`name`	string	Ja	Navn på den nye gruppe
`parent_id`	string (UUID)	Ja	ID på forældregruppen (skal være inden for scope)

GroupUpdateRequest¶

Request body ved PUT /v1/groups/{id}.

Felt	Type	Påkrævet	Beskrivelse
`name`	string	Ja	Nyt gruppenavn

Lokale brugere¶

LocalUser¶

Standardrepræsentation af en lokal bruger.

Felt	Type	Beskrivelse
`id`	string (UUID)	Brugerens unikke ID
`email`	string	E-mailadresse
`firstname`	string	Fornavn
`lastname`	string	Efternavn
`role`	string	Brugerrolle (fx `user`, `admin`)
`group_id`	string (UUID)	Gruppetilhørsforhold

LocalUserListResponse¶

Returneres ved GET /v1/groups/{groupId}/local-users.

Felt	Type	Beskrivelse
`items`	LocalUser[]	Liste af brugere
`total_count`	integer	Totalt antal (uafhængigt af paginering)
`offset`	integer	Aktuel offset
`limit`	integer	Aktuel limit

LocalUserCreateRequest¶

Request body ved POST /v1/groups/{groupId}/local-users.

Felt	Type	Påkrævet	Beskrivelse
`email`	string	Ja	E-mailadresse (unik i organisationen)
`firstname`	string	Ja	Fornavn
`lastname`	string	Ja	Efternavn
`password`	string	Ja	Initial adgangskode
`role`	string	Ja	Brugerrolle

LocalUserUpdateRequest¶

Request body ved PUT /v1/groups/{groupId}/local-users/{userId}.

Felt	Type	Påkrævet	Beskrivelse
`email`	string	Ja	Opdateret e-mailadresse
`firstname`	string	Ja	Opdateret fornavn
`lastname`	string	Ja	Opdateret efternavn
`role`	string	Ja	Opdateret rolle

PasswordChangeRequest¶

Request body ved PUT /v1/groups/{groupId}/local-users/{userId}/password.

Felt	Type	Påkrævet	Beskrivelse
`password`	string	Ja	Ny adgangskode

MoveUserRequest¶

Request body ved POST .../local-users/{userId}/move og POST .../external-users/{userId}/move.

Felt	Type	Påkrævet	Beskrivelse
`destination_group_id`	string (UUID)	Ja	Mål-gruppens ID (skal være inden for scope)

Eksterne brugere¶

ExternalUser¶

Standardrepræsentation af en eksternt provisioneret bruger.

Felt	Type	Beskrivelse
`id`	string (UUID)	Brugerens unikke ID
`email`	string	E-mailadresse
`firstname`	string	Fornavn
`lastname`	string	Efternavn
`identity_provider`	string	Navn på den eksterne IdP
`group_id`	string (UUID)	Gruppetilhørsforhold

ExternalUserListResponse¶

Returneres ved GET /v1/groups/{groupId}/external-users.

Felt	Type	Beskrivelse
`items`	ExternalUser[]	Liste af brugere
`total_count`	integer	Totalt antal
`offset`	integer	Aktuel offset
`limit`	integer	Aktuel limit

Autorisationer¶

Authorization¶

Standardrepræsentation af en autorisation.

Felt	Type	Beskrivelse
`id`	string (UUID)	Autorisationens unikke ID
`user_email`	string	E-mail på den autoriserede bruger
`role`	string	Rolle (fx `group_admin`, `org_admin`)
`group_id`	string (UUID)	Gruppen autorisationen gælder for

AuthorizationCreateRequest¶

Request body ved POST /v1/groups/{groupId}/authorizations.

Felt	Type	Påkrævet	Beskrivelse
`user_email`	string	Ja	E-mail på brugeren
`role`	string	Ja	Rolle der tildeles

AuthorizationUpdateRequest¶

Request body ved PUT /v1/groups/{groupId}/authorizations/{authId}.

Felt	Type	Påkrævet	Beskrivelse
`role`	string	Ja	Ny rolle

Fejlrespons¶

ProblemDetails¶

Alle fejlresponser følger RFC 9457 (application/problem+json).

Felt	Type	Beskrivelse
`status`	integer	HTTP-statuskode
`title`	string	Kort fejlbeskrivelse
`detail`	string	Detaljeret forklaring
`type`	string (URI)	Fejltype-identifikator (valgfri)
`instance`	string (URI)	Request-identifikator (valgfri)

Se Reference — Fejlkoder for komplet oversigt.