# Enable or disable a connected account

**Documentation:** /reference/api-reference/connected-accounts/patchConnectedAccountsByNanoIdStatus

Updates the status of a connected account to either enabled (active) or disabled (inactive). Disabled accounts cannot be used for API calls but remain in the database.

---

## PATCH `/api/v3/connected_accounts/{nanoId}/status`

**Endpoint:** `https://backend.composio.dev/api/v3/connected_accounts/{nanoId}/status`

**Summary:** Enable or disable a connected account

Updates the status of a connected account to either enabled (active) or disabled (inactive). Disabled accounts cannot be used for API calls but remain in the database.

### Authentication

**ApiKeyAuth** - API Key in `header` header `x-api-key` OR **UserApiKeyAuth** - API Key in `header` header `x-user-api-key`

### Path Parameters

- `nanoId` (string (connectedAccountId)) *(required)*: The unique identifier of the connected account

### Request Body

**Schema:**

- `enabled` (boolean) *(required)*: Set to true to enable the account or false to disable it

**Example:**

```json
{
  "enabled": true
}
```

### Responses

#### 200 - Successfully updated the connected account status. If enabled=true, the account status is set to ACTIVE; if enabled=false, the status is set to INACTIVE.

**Response Schema:**

- `success` (boolean) *(required)*: Indicates whether the connected account status was successfully updated

**Example Response:**

```json
{
  "success": true
}
```

#### 400 - Bad request - Invalid nanoid format or invalid request body

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 401 - Unauthorized - Authentication failed

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 403 - Forbidden - Insufficient permissions to update this connected account

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 404 - Connected account not found - The specified account does not exist or has been deleted

**Response Schema:**


#### 500 - Internal server error - Failed to update the connected account status due to a server-side issue

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

### Example cURL Request

```bash
curl -X PATCH "https://backend.composio.dev/api/v3/connected_accounts/string/status" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true
  }'
```