> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Einen geteilten Benutzer aktualisieren

> PUT /multi-users/{pk}/

Geteilte Benutzer sind die Teammitglieder, die Sie in Ihr Scanova-Konto einladen — dieselbe Liste, die in der **Benutzer**-Tabelle des Dashboards angezeigt wird. Mit diesem Endpunkt können Sie sie programmatisch auflisten, einladen, aktualisieren oder entfernen.

<Note>
  Dieser Endpunkt war bisher nicht dokumentiert. Er erfordert einen Management-API-Schlüssel mit `MANAGEMENT_API`- (oder `MANAGEMENT_API_SANDBOX`-)Quota, gesendet als roher `Authorization`-Header-Wert — siehe die [Management-API-Übersicht](/de/api-reference/management-api/overview) — sowie die eigene Team-Quota des Kontos für geteilte Benutzer. Was jede Rolle tatsächlich gewährt, erfahren Sie unter [Rollen & Berechtigungen](/de/team/roles-and-permissions); das Wire-Format der Rollen selbst finden Sie unter [Rollen (Zugriffsebenen)](/de/api-reference/management-api/shared-users/roles-list).
</Note>

<ParamField path="pk" type="integer" required>
  Die Datensatz-ID des geteilten Benutzers aus der obigen Listenantwort.
</ParamField>

<CodeGroup>
  ```bash Update role theme={null}
  curl --request PUT \
    --url 'https://management.scanova.io/multi-users/118/' \
    --header 'Authorization: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{"access_level": 3}'
  ```

  ```bash Deactivate theme={null}
  curl --request PUT \
    --url 'https://management.scanova.io/multi-users/118/' \
    --header 'Authorization: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{"is_active": false}'
  ```
</CodeGroup>

`PUT` gibt dieselbe Form wie die obige Einladungs-Antwort zurück.

<Note>
  `email` und `name` gelten nur bei der Erstellung — werden sie in einem `PUT`-Body gesendet, wird dies stillschweigend ignoriert statt einen Fehler auszulösen, da die Identität eines geteilten Benutzers nach dem Versand der Einladung nicht mehr geändert werden kann. Um die Rolle, den Tag-Geltungsbereich oder den aktiven Status zu aktualisieren, verwenden Sie nur die Felder, die Sie tatsächlich ändern möchten.
</Note>

## Verwandte Themen

* [Geteilte Benutzer auflisten](/de/api-reference/management-api/shared-users/list) — finden Sie die `pk`, mit der Sie hier arbeiten.
* [Einen geteilten Benutzer abrufen](/de/api-reference/management-api/shared-users/retrieve) — eine andere Operation an diesem selben `{pk}`-Endpunkt.
* [Einen geteilten Benutzer entfernen](/de/api-reference/management-api/shared-users/remove) — eine andere Operation an diesem selben `{pk}`-Endpunkt.
* [Rollen auflisten](/de/api-reference/management-api/shared-users/roles-list) — suchen oder erstellen Sie die `access_level`-ID, die die Einladungs-/Aktualisierungs-Aufrufe dieses Endpunkts benötigen.
* [Eine benutzerdefinierte Rolle erstellen](/de/api-reference/management-api/shared-users/roles-create) — suchen oder erstellen Sie die `access_level`-ID, die die Einladungs-/Aktualisierungs-Aufrufe dieses Endpunkts benötigen.
* [Geteilte Benutzer](/de/team/shared-users) — die eigene Benutzer-Tabelle des Dashboards, die dieselben Einladungs-/Deaktivierungs-/Entfernungs-Aktionen zeigt.
* [Rollen & Berechtigungen](/de/team/roles-and-permissions) — was jede Rolle einem Teammitglied tatsächlich gewährt.


## OpenAPI

````yaml api-reference/openapi/management-api.json PUT /multi-users/{pk}/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    management.scanova.io (QR codes, folders, tags, leads, forms, analytics,
    plans, shared users & roles), plus the token-creation and usage-stats
    endpoints used to authenticate against it. Every path and request/response
    shape below was verified live against a real API key and the actual running
    backend (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://management.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /multi-users/{pk}/:
    put:
      summary: Update a shared user's role/access
      description: >-
        email and name are create-only and are silently ignored if sent here — a
        shared user's identity can't change after invite.
      operationId: updateManagedSharedUser
      parameters:
        - name: pk
          in: path
          required: true
          schema:
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                access_level:
                  type: integer
                is_active:
                  type: boolean
                tags:
                  type: array
                  items:
                    type: integer
                enable_tag_permission:
                  type: boolean
                include_untagged:
                  type: boolean
            example:
              access_level: 3
      responses:
        '200':
          description: Shared user updated.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. management.scanova.io) — the same key sent to
        the regular API host will not authenticate.

````