Skip to main content
PUT
Update a shared user's role/access
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.
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 — sowie die eigene Team-Quota des Kontos für geteilte Benutzer. Was jede Rolle tatsächlich gewährt, erfahren Sie unter Rollen & Berechtigungen; das Wire-Format der Rollen selbst finden Sie unter Rollen (Zugriffsebenen).
integer
erforderlich
Die Datensatz-ID des geteilten Benutzers aus der obigen Listenantwort.
PUT gibt dieselbe Form wie die obige Einladungs-Antwort zurück.
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.

Verwandte Themen

Autorisierungen

Authorization
string
header
erforderlich

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.

Pfadparameter

pk
integer
erforderlich

Body

application/json
access_level
integer
is_active
boolean
tags
integer[]
enable_tag_permission
boolean
include_untagged
boolean

Antwort

200

Shared user updated.