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

# Listar etiquetas visibles para tu rol de usuario compartido

> GET /tag/shared/

Lista las etiquetas para las que el rol de un usuario compartido ha recibido visibilidad, en el host de la **API de gestión** (`api.scanova.io`), autenticado con tu clave sin procesar de la API de gestión.

```
GET https://api.scanova.io/tag/shared/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.scanova.io/tag/shared/" \
    -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    { "id": 12, "name": "vip" },
    { "id": 14, "name": "east-region" }
  ]
  ```
</ResponseExample>

No paginado — devuelve un array simple.

## Solo tiene sentido para la clave de un usuario compartido

Este endpoint solo tiene sentido para una clave de API de gestión creada en nombre de un usuario compartido cuya cuenta tenga habilitados los [permisos basados en etiquetas](/es/team/roles-and-permissions). Una clave perteneciente al propietario de la cuenta (que de entrada no está limitado por etiquetas) devuelve `400` con `{"error": ["Request user is not a shared user"]}`.

## Relacionado

* [Listar etiquetas](/es/api-reference/management-api/tags/manage) — el equivalente sin restricciones, para el propietario de la cuenta.
* [Listar/desvincular etiquetas adjuntadas por un usuario compartido](/es/api-reference/management-api/tags/attached-list) — una vista distinta: lo que un compañero ha etiquetado, no lo que puede ver.
* [Roles y permisos](/es/team/roles-and-permissions) — cómo funciona la limitación de permisos basada en etiquetas desde el panel.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y las reglas de cuota que aplican a este endpoint.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /tag/shared/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.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://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /tag/shared/:
    get:
      summary: List tags visible to your shared-user role
      description: >-
        Lists the tags a shared user's role has been granted visibility into
        (via tag-based permission scoping). Only meaningful for a Management API
        key created on behalf of a shared user — a key belonging to the account
        owner returns 400, since the owner isn't scoped by tag permissions in
        the first place.
      operationId: listManagedSharedTags
      responses:
        '200':
          description: Tags visible to this shared user. Not paginated.
          content:
            application/json:
              example:
                - id: 12
                  name: vip
                - id: 14
                  name: east-region
        '400':
          description: The requesting key does not belong to a shared user.
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. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````