---
title: "Disconnect a Stripe account"
method: POST
path: "/companies/{companyId}/integrations/stripe/disconnect"
tags: ["Stripe Connect"]
---

# Disconnect a Stripe account

`POST /companies/{companyId}/integrations/stripe/disconnect`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/integrations/stripe/disconnect`
- Auth: HTTP bearer

Marks the connection disconnected. Connection rows are never deleted — the imported transaction archive is bound to them.

## Request body

- StripeDisconnectInput
  - `connectionId` string, uuid: Which installed Stripe account to disconnect. Omitted disconnects the company's only connection.

## Response `200`

Disconnected

- StripeDisconnectResponse
  - `success` true, required
  - `data` object, required
    - `disconnected` true, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)
