> ## 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.

# Actualizar un usuario compartido

> PUT /multi-users/{pk}/

Los usuarios compartidos son los compañeros de equipo que invitas a tu cuenta de Scanova — la misma lista que se muestra en la tabla **Users** del panel. Este endpoint te permite listarlos, invitarlos, actualizarlos o eliminarlos de forma programática.

<Note>
  Este endpoint no estaba documentado anteriormente. Requiere una clave de la API de gestión con cuota `MANAGEMENT_API` (o `MANAGEMENT_API_SANDBOX`), enviada como el valor sin procesar del encabezado `Authorization` — consulta el [resumen de la API de gestión](/es/api-reference/management-api/overview) — además de la propia cuota de Team de la cuenta para usuarios compartidos. Para saber qué otorga realmente cada rol, consulta [Roles y permisos](/es/team/roles-and-permissions); para el formato de transmisión de los propios roles, consulta [Roles (niveles de acceso)](/es/api-reference/management-api/shared-users/roles-list).
</Note>

<ParamField path="pk" type="integer" required>
  El ID del registro de usuario compartido de la respuesta de listado anterior.
</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` devuelve la misma forma que la respuesta de invitación anterior.

<Note>
  `email` y `name` son solo para creación — enviarlos en un cuerpo `PUT` se ignora silenciosamente en lugar de generar un error, ya que la identidad de un usuario compartido no se puede cambiar después de enviar la invitación. Para actualizar el rol, el alcance de etiquetas o el estado activo, usa solo los campos que quieras cambiar.
</Note>

## Relacionado

* [Listar usuarios compartidos](/es/api-reference/management-api/shared-users/list) — encuentra el `pk` con el que operar aquí.
* [Obtener un usuario compartido](/es/api-reference/management-api/shared-users/retrieve) — otra operación de este mismo endpoint `{pk}`.
* [Eliminar un usuario compartido](/es/api-reference/management-api/shared-users/remove) — otra operación de este mismo endpoint `{pk}`.
* [Listar roles](/es/api-reference/management-api/shared-users/roles-list) — busca o crea el ID de `access_level` que requieren las llamadas de invitar/actualizar de este endpoint.
* [Crear un rol personalizado](/es/api-reference/management-api/shared-users/roles-create) — busca o crea el ID de `access_level` que requieren las llamadas de invitar/actualizar de este endpoint.
* [Usuarios compartidos](/es/team/shared-users) — la propia tabla Users del panel, que muestra las mismas acciones de invitar/desactivar/eliminar.
* [Roles y permisos](/es/team/roles-and-permissions) — qué otorga realmente cada rol a un compañero de equipo.


## 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.

````