Skip to main content
PUT
Update a shared user's role/access
Shared users are the teammates you invite into your Scanova account — the same list shown on the dashboard’s Users table. This endpoint lets you list, invite, update, or remove them programmatically.
This endpoint was not previously documented. It requires a Management API key with MANAGEMENT_API (or MANAGEMENT_API_SANDBOX) quota, sent as the raw Authorization header value — see the Management API overview — plus the account’s own Team quota for shared users. For what each role actually grants, see Roles & permissions; for the wire format of roles themselves, see Roles (access levels).
integer
required
The shared-user record ID from the list response above.
PUT returns the same shape as the invite response above.
email and name are create-only — sending them in a PUT body is silently ignored rather than erroring, since a shared user’s identity can’t be changed after the invite is sent. To update the role, tag scope, or active state, use only the fields you intend to change.

Authorizations

Authorization
string
header
required

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.

Path Parameters

pk
integer
required

Body

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

Response

200

Shared user updated.