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

# Desactivar una conexión

> Corta una conexión: deja de servir para operar y Tupana suelta la clave que guardaba. No es un borrado — la conexión sigue en el listado con `status: inactive`, que es lo que explica por qué esa empresa dejó de sincronizar. La empresa y sus documentos no se tocan. Se identifica por `connection_id` (el `cred_…` del listado), no por la empresa. Es idempotente y no tiene vuelta atrás: volver a operar esa empresa significa conectarla de nuevo con Tupana Link.

Corta una conexión: deja de servir para operar y Tupana suelta la clave que
guardaba. Si era una empresa que sincronizaba su banco o su SII todos los días,
deja de hacerlo.

Se identifica por `connection_id` — el `cred_…` que devuelve
[el listado](/api-reference/v2/connections/list) —, no por la empresa: una
empresa puede tener más de una conexión y se desactiva la que indiques.

```bash theme={null}
curl -X DELETE https://api.tupana.ai/v2/connections/cred_5028174639201/ \
  -H "Authorization: Api-Key TU_API_KEY"
```

Responde `204` sin cuerpo. Si esa conexión no es tuya o no existe, `404`.

## No es un borrado

La conexión sigue apareciendo en el listado con `status: inactive`. Es a
propósito: así se entiende por qué esa empresa dejó de sincronizar, en vez de
desaparecer sin explicación. La empresa y sus documentos no se tocan.

<Info>
  `inactive` es una conexión que alguien cortó. No se confunde con
  `requires_action`, que es una clave que dejó de funcionar y hay que reconectar
  con [Tupana Link](/api-reference/v2/connect/tupana-link).
</Info>

Volver a operar esa empresa significa conectarla de nuevo con Tupana Link: la
clave no se recupera.

<Warning>
  Desactivar es idempotente —llamarlo dos veces responde `204` las dos— pero no
  tiene vuelta atrás por API.
</Warning>


## OpenAPI

````yaml api-reference/openapi-v2.json DELETE /connections/{connection_id}/
openapi: 3.0.0
info:
  title: Tupana API — v2
  description: >-
    API v2 de Tupana: facturación electrónica, cesiones, recaudación, consultas,
    boleta de honorarios y nómina. Los identificadores de recursos son public
    IDs opacos con prefijo (docu_, ment_, cred_, doce_, empl_…).
  version: 2.0.0
servers:
  - url: https://api.tupana.ai/v2
    description: Producción (v2)
security:
  - apiKeyAuth: []
paths:
  /connections/{connection_id}/:
    delete:
      tags:
        - Conexiones
      summary: Desactivar una conexión
      description: >-
        Corta una conexión: deja de servir para operar y Tupana suelta la clave
        que guardaba. No es un borrado — la conexión sigue en el listado con
        `status: inactive`, que es lo que explica por qué esa empresa dejó de
        sincronizar. La empresa y sus documentos no se tocan. Se identifica por
        `connection_id` (el `cred_…` del listado), no por la empresa. Es
        idempotente y no tiene vuelta atrás: volver a operar esa empresa
        significa conectarla de nuevo con Tupana Link.
      operationId: deactivateConnection_v2
      parameters:
        - name: connection_id
          in: path
          required: true
          schema:
            type: string
            example: cred_5028174639201
          example: ment_3672486436546233854
          description: Id de la conexión (`cred_…`), el que devuelve GET /connections/.
      responses:
        '200':
          description: Conexión terminada
        '404':
          description: La empresa no está conectada a tu integración
components:
  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)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.