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

# Desenrolar Entidad

> Elimina la asociación entre el usuario de la api key y la entidad maestra

## Que hace

* Elimina la asociación entre el usuario de la api key y la entidad maestra
* No elimina la entidad maestra ni sus credenciales, solo desvincula al usuario
* Otros usuarios que estén asociados a la misma entidad mantienen su acceso

## Ejemplos de uso

* Dejar de administrar una entidad desde la api key actual
* Revertir un enrolamiento hecho por error
* Limpiar entidades que ya no corresponden a la integración

### Obtener el master\_entity\_id

El `master_entity_id` es el ID unico de la empresa en Tupana que se esta desasociando. Para obtener este ID, debes usar el endpoint `/master-entities`:

1. **Buscar la entidad por RUT** usando `GET /master-entities?rut=76543210-1`
2. **Obtener el ID** de la respuesta (campo `id`)
3. **Usar ese ID** como `master_entity_id` en la ruta del endpoint

### Importante

* El usuario de la api key debe estar asociado a la entidad, de lo contrario se retorna `404`
* Esta acción no puede deshacerse automáticamente: para volver a acceder a la entidad se debe crear una nueva credencial (ver [Crear Credencial](/api-reference/credentials/create))


## OpenAPI

````yaml DELETE /credentials/{master_entity_id}
openapi: 3.0.0
info:
  title: Tupana API
  description: API para integración con el sistema Tupana - Facturación Electrónica
  version: 1.0.0
servers:
  - url: https://api.tupana.ai/v1
    description: Servidor de producción
security:
  - apiKeyAuth: []
paths:
  /credentials/{master_entity_id}:
    delete:
      tags:
        - Credenciales
      summary: Desenrolar entidad
      description: >-
        Elimina la asociación entre el usuario de la api key y la entidad
        maestra
      operationId: unenrollCredential
      parameters:
        - name: master_entity_id
          in: path
          required: true
          schema:
            type: integer
          description: ID de la entidad maestra a desenrolar
          example: 123
      responses:
        '204':
          description: Entidad desenrolada exitosamente
        '401':
          description: No autorizado - API key inválida o faltante
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Prohibido - Sin permisos para desenrolar entidades
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Entidad maestra no encontrada o no asociada al usuario
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKeyAuth: []
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
          description: Código de error
          example: VALIDATION_ERROR
          enum:
            - VALIDATION_ERROR
            - AUTHENTICATION_ERROR
            - AUTHORIZATION_ERROR
            - NOT_FOUND
            - SII_ERROR
            - INTERNAL_ERROR
        message:
          type: string
          description: Mensaje de error
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API Key para autenticación. Debe proporcionarse en el header
        Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo
        'Api-Key ' seguido de tu API key)

````