---
title: "Enable or disable an authentication configuration"
method: PATCH
path: "/api/v3.1/auth_configs/{nanoid}/{status}"
tags: ["Auth Configs"]
---

# Enable or disable an authentication configuration

`PATCH /api/v3.1/auth_configs/{nanoid}/{status}`

Updates the status of an authentication configuration to either enabled or disabled. Disabled configurations cannot be used for new connections.

## Path parameters

- `nanoid` string, authConfigId, required — The unique identifier of the authentication configuration to update
- `status` 'ENABLED' | 'DISABLED', required — The new status to set for the auth configuration

## Response `200`

Successfully updated auth config status

- object

## Other responses

- `400` — Bad request - Invalid auth config ID or status value
- `401` — Unauthorized - Authentication required
- `404` — Not found - Auth configuration does not exist
- `500` — Internal server error - Something went wrong on the server

## Changes

- **2026-06-17** `589a7d115a5e` — 1 info
  - the endpoint scheme security `UserApiKeyAuth` was removed from the API
- **2026-05-29** `ca2b1b8e1372` — 1 info
  - the endpoint scheme security `CookieAuth` was removed from the API
- **2026-05-05** `52c71f747c65` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/changes/api/v3.1/auth_configs/:nanoid/:status/patch.md)

---

[API](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)